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Overview 


About This Manual 


The DYNIX/ptx Reference Manual is for programmers working in the 
DYNIX/ptx operating system environment. This manual describes the 
programming features of the operating system and assumes that the 
audience is familiar with the operating system. It does not provide a general 
overview of the operating system or implementation details of the system. 


Organization 


The DYNIX/ptx Reference Manual is contained in five binders organized as 


follows: 
¢ Section 1 A-F 


¢ Section 1 G-Z 


Commands 


Commands 


¢ Section 2 System Calls 

Section 2SEQ Sequent System Calls 

Section 3 Subroutines 
Section 3C C Library Routines 
Section 3M Mathematical Library Routines 
Section 3N Networking Support Utilities 
Section 3PPS Sequent Parallel] Programming Library 
Section 3S Standard V/O Library Routines 
Section 3SEQ Sequent I/O Library Routines 
Section 3X Special Routines 


¢ Section 4 
Section 5 


¢ Section 7 
Section 8 


File Formats 
Miscellaneous Facilities 


Special Files 
Stand-alone Utilities 
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Each binder also contains the following items: 


¢ Table of Contents that alphabetically lists the contents of the entire 
manual set 


¢ Permuted Index that lists each programming feature in the entire 
manual set 


The permuted index is a list of keywords, given alphabetically in the second 
of three columns, together with the context in which each keyword is found. 
The following shows four separate entries illustrating four ways that the cat 
command can be looked up in the permuted index. Note that you can find the 
cat command by looking up “cat,” “concatenate,” “files,” or “print.” 


cat: concatenate and print files........... cat (1) 

cat: concatenate and print files...........-... cat (1) 

* concatenate and print fileS....ccwiccccccaccsccccccccccesncsssces cat (1) 
concatenate and print files... .ceccccesccseccsevercecsees cat (1) 


Keywords are either topical keywords or the names of manual entries 
themselves. Entries are identified with their section numbers shown in 
parentheses. The numbers are important because there is duplication of 
names among the sections. The right column lists the name of the manual 
page on which each keyword may be found. The left column contains useful 
information about the keyword. 


The following paragraphs briefly describe the other sections of the manual. 


Section 1: Commands describes operating system commands and 
commands that support C and other programming languages. 


Section 2: System Calls describes the access to the services provided by the 
operating system kernel, including the C language interface. 


Section 2SEQ: Sequent System Calls describes the access to the Sequent 
services provided by the operating system kernel, including the C language 
interface. 


Section 3: Subroutines describes the available subroutines. Their binary 
versions reside in various system libraries in the directories /lib and 
/usr/lib. The introduction to Section 3 describes these libraries and the files 
in which they are stored. 
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Section 4: File Formats documents the structure of particular kinds of 
files; for example, the format of the output of the link editor is given in 
a.out(4). Excluded are files used by only one command (for example, the 
assembler’s intermediate files). In general, the C language structures 
corresponding to these formats can be found in the directories /usr/include 
and /usr/include/sys. 


Section 5: Miscellaneous Facilities contains a variety of descriptions 
including descriptions of character sets, macro packages, and so forth. 


Section 7: Special Files describes various special files that refer to specific 
hardware peripherals and operating system device drivers. 


Section 8: Stand-alone Utilities describes stand-alone procedures. 


References to manual pages with numbers other than those above mean that 
the utility is contained in the appropriate section of another manual. Each 
section consists of independent entries which are alphabetized, with the 
exception of the introductions that begin some sections. Section 3 is divided 
into subsections in alphabetical order by suffix. Some entries may describe 
several routines, commands, and so forth. In such cases, the entry appears 
only once, alphabetized under its primary name, the name that appears at 
the upper corners of each manual page. 


Each manual page can be viewed online with the man(1) command. For 
example, enter man shell to view the shell manual page. Enter man man 
for more information about the man command. 


Notational Conventions 


Manual pages are based on a common format. The main headings are 
described here—not all of them appear in all cases: 


¢ NAME gives the name(s) of the entry and briefly states its purpose. 
This entry is used to create the Permuted Index and the Table of 
Contents. 


* ¢ SYNOPSIS summarizes the usage of the program being described. 
Conventions vary in some sections but are generally as follows: 
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¢ Boldface strings are literals and are to be typed just as they © 
appear. 


¢ Italic strings usually represent substitutable argument prototypes 
and program names found elsewhere in the manual. 


¢ Square brackets [] around an argument prototype indicate that 
the argument is optional. When an argument prototype is given 
as name or file, it refers to a filename. 


e Ellipses ... are used to show that the previous argument 
prototype may be repeated. 


e A final convention is used by the commands themselves. An 
argument beginning with a minus -, plus +, or equal sign = is often 
taken to be some sort of flag argument even if it appears in a 
position where a file name could appear. Therefore, it is unwise to 
have files whose names begin with -, +, or =. 


¢ CONFIGURATION ENTRY shows how a driver is called out in a system 
configuration file. 


¢ DESCRIPTION describes the entry, including its purpose and how it is 
used. 


¢ FIELDS describe system file or record entries. 
¢ EXAMPLES and BINARY CONFIGURATION give examples of usage. 


¢ FILES list files that are part of a program, created by a program, or 
related to a program. 


¢ SEE ALSO points to related information in other manual pages. 


¢ DIAGNOSTICS discuss the diagnostic (error) messages that may be 
produced. Messages that are self-explanatory are not listed. 


¢ WARNINGS contains warnings against improper user actions. 
¢ NOTES give hints about the use of the utility. 
¢ BUGS describe known bugs in the software. 
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nulladm, pretmp, prdaily, prtacct, 
shutacct, startup, turnacct 
addcmdopt(1M) ... 
addformopt(1M) . 
addmenuopt(1M) . 
admin(1) .... 


.. process accounting 


shell procedures for accounting 

add a command option to a menu 

.. add a form/SELECT window option to a menu 
.. add a menu option to a menu 

.. create and administer SCCS files 


apropos(1) . locate commands by keyword lookup 

ar(1) .... see C and Language Tools Binder 

as(1) see C and Language Tools Binder 

asa(1) ... interpret ASA carriage control characters 
assist(1) assistance using operating system commands 


.. program for generating/modifying ASSIST menus or 
command forms 

.. execute commands at a later time 

pattern scanning and processing language 
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deliver portions of pathnames 

arbitrary-precision arithmetic language 

.. system initialization procedures 

.. update daemon 

big diff 

big file scanner 

.. perform an installation Geaiiency, check based on 
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astgen(1) 


at(1): at, batch ... 


bomverify(1M) .... 


bootflags(1M) ... . display/change system boot flags 
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calendar(1) .... . reminder service 
captoinfo(1M) . convert a termcap description into a terminfo description 
cat(1) ... . concatenate and print files 


. see C and Language Tools Binder 

. see C and Language Tools Binder 

. change working directory 
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. see C and Language Tools Binder 
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. check a filesystem 

Saas . change mode 

. change owner or group 


cb(1) . 


chroot(1M) . . change root directory for a command 

chrtbl(1M) . generate character classification and conversion tables 
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ckbupscd(1M) .. check filesystem backup schedule 

clri(1M) .. .. Clear inode 
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co(1) . . check out RCS revisions 
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col(1) 
comb(1) 
comm(1) .. 
compress(1): compress, 


uncompress, zcat compress and expand data 


Config(1M)  .sesccsssessseees suse DUild system configuration files 
coproc(1F): cocreate, cosend, 

cocheck, coreceive, COdestTOY essere communicate to a process 

cp(1): cp, ln, mv .. copy, link or move files 

cpp(1) ... . see C and Language Tools Binder 

cpio(1) ... . copy file archives in and out 

cpra(1) .. . see C and Language Tools Binder 

cpset(1) . copy file and set mode, user, and group IDs 
crash(1M) . examine system images 

cron(1M) ..... . clock daemon 

crontab(1) . user crontab file 

crypt(1) encode/decode 

cesh(1) ... a shell (command interpreter) with C-like syntax 
csplit(1) context split 

ct(1C) .... spawn getty to a remote terminal 

ctage(1) create a tags file ‘ 

ctrace(1) see C and Language Tools Binder 

cu(1C) ... call another UNIX system 


cut out selected fields of each line of a file 
see C and Language Tools Binder 
... print and set the date 
. see C and Language Tools Binder 
desk calculator 
filesystem directory consistency check 
convert and copy a file 
.. make a delta (change) to an SCCS file 


cut(1) ... 


delta(1) 
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differential file comparison 
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dis(1) .. .. see C and Language Tools Binder 
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dump{1) .. see C and Language Tools Binder 
dump(1M) . incremental filesystem dump 
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ed(1): ed, red .. text editor 

edc(1M) . .. Tun an externally described command 
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enable(1): enable, disable enable/disable LP printers 

env(l) . .. Bet environment for command execution 
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functions 


fack(1M) .. filesystem consistency check and interactive repair 
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lint(1) ... .. see C and Language Tools Binder 

list(1) see C and Language Tools Binder 
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login(1) . sign on 

logname(1) get login name 

lorder(1) ....... see C and Language Tools Binder 

Ip(1): Ip, cancel . send/cancel requests to the LP print service 
lpadmin(1M) configure the LP print service 


Ipfilter(1M) . 
Ipforms(1M) ... 


administer filters used with the LP print service 
.. administer forms used with the LP print service 
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Ipstat(1) print information about the status of the LP print service 
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MALIbUG(1) ...csesssseees submit a bug report or enhancement request 
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.. log in to a new group 
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newform(1) 
newfe(1M) . 
newgrp(1M) 
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or processor migration disabled 
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.. octal dump 

bring processors online and offline 


onproc . 
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BOLE Pid wsssscsssssssssssessersssessseeens Bet real user, effective user, real group, and effective 
group IDs 

joct(2) ... .. control device 

kill(2) . send a signal to a process or a group of processes 

link(2) link to a file 

lseek(2) move read/write file pointer 

mkdir(2) .. make a directory 


.. make a directory, or a special or ordinary file 
mount a filesystem 


mknod(2): mknod .. 
mount(2) .. 


magetl(2) message control operations 
msgget(2) get message queve 

msgop(2) message operations 

nice(2) change priority of a process 

open(2) .. ... open for reading or writing 
pathconf{(2): pathconf, fpathconf .. get configurable pathname variables 
pause(2) .. suspend process until signal 

pipe(2) create an interprocess channel 
plock(2) . lock process, text, or data in memory 
poll(2) STREAMS input/output multiplexing 


profil(2) . execution time profile 
ptrace(2): ptrace, mptrace . . process trace facility 
putmsg(2) . .. send a message on a stream 
read(2) ... read from file 

rename(2) change the name of a file 
rmdir(2) ..... .. remove a directory 
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semctl(2) ... .. semaphore control operations 
semget(2) get set of semaphores 

semop(2) .... semaphore operations 

setpgid(2) .. manipulate signal sets 

setpgrp(2) set process group ID 

setsid(2) . create session and set process group ID 
setuid(2): setuid, setgid set user and group IDs 

shmctl(2) ... shared memory control operations 
shmget(2) .. get shared memory segment identifier 
shmop(2): shmop, shmat, shmdt . shared memory operations 
BIQACLION(Z) srssssssesncsssessereecsseaes eseies .. examine and change signal actions 


sigemptyset(2): sigemptyset, 
sigfillset, sigaddset, sigdelset, 


sigismember .. manipulate signal sets 

signal(2) .... specify what to do upon receipt of a signal 
sigpending(2) examine pending signals 

sigprocmask(2) ... examine and change blocked signals 


sigset(2): sigset, sighold, sigrelse, 
sigignore, sigpause 

sigsuspend(2) ....... on 
stat(2): stat, lstat, fetat 
statfa(2): statfs, fatatis 
BtIME(Z) creccsesesecreesees 
stty(2): stty, gtty 
sync(2) .... 
syscall(2) 
sysconf{{2) 
sysi86(2) . 
tegetattr(2): tcgetattr, tcsetattr 
tegetpgrp(2) .. 


.. Signal management 

wait for a signal 

get file status 

get filesystem information 

set time 

set and get terminal state (defunct) 
update superblock 

indirect system call 

get configurable system variables 
machine specific functions 

get/set terminal state 

get foreground process group ID 


tesetpgrp(2) .. set foreground process group ID 
time(2) .... .. get time 

times(2) .. get process and child process times 
uadmin(2) . .. administrative control 

ulimit(2) .... .. get and set user limits 

umask(2) ... set and get file creation mask 
umount(2) . ... unmount a filesystem 

uname(2) ... .. get name of current operating system 
unlink(2) remove directory entry 

ustat(2) ...0.. get filesystem statistics 

utime(2) .. set file access and modification times 
vfork(2) ... spawn new process in a virtual memory efficient way 


wait(2): wait, waitpid ... wait for a child process to stop or terminate 
WYIte(Z)  .secessseen sesbeasoeeseorereansen os sesoevnseabate write on a file 
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2SEQ Sequent System Calls 


intro(2SEQ) .. introduction to Sequent system calls 
bdflush(2SEQ) .. update daemon 
fvhangup(2SEQ) .. virtually hangup the specified controlling terminal 


get_process_stats(2SEQ) get resource utilization information 
getdtablemax(2SEQ) .. get maximum in-use descriptor table index 
getdtablesize(2SEQ) .. .. get descriptor table size 
getpagesize(2SEQ) . -. get system page size 

mmap(2SEQ) ....... map an open file into the processs address space 
munmap(2SEQ) unmap part of the processs address space 
proc_ctl(2SEQ) control over various process attributes 
quotactl(2SEQ) manipulate disk quotas 

readlink(2SEQ) .. read value of a symbolic link 

readv(2SEQ) .... .. read vector from file 

setdtablesize(2SEQ) .. set descriptor table size 

setgroups(2SEQ) . .. set group access list 

sigcontext(2SEQ) .. . get signal context 

sigstack(2SEQ) .... .. set and/or get signal stack context 
symlink(2SEQ) .... make symbolic link to a file 


tmp_affinity(2SEQ) 
tmp_ctl(2SEQ) .. 
truncate(2SEQ): truncate, 


bind a process to a processor 
.. multi-processor control 


ftruncate wu... .. truncate a file to a specified length 
vm_ctl(2SEQ) examine and change virtual memory tuning parameters 
writev(2SEQ) ... .. Write vector on a file 


3 Subroutines 
UNtTO(S) wesssesseresssrnccnsnesnsnseessees suseeeee introduction to functions and libraries 


3C C Library Routines 


a641(3C): a641, 164a ... 
abort(3C) ... 
abs(3C) . 


.. convert between long integer and base-64 ASCII string 
.. generate an JOT fault 
return integer absolute value 


bsearch(3C) binary search a sorted table 
clock(3C) ... .. report CPU time used 
conv(3C): toupper, tolower, 

_toupper, _tolower, toascii .......000.. translate characters 


crypt(3C): crypt, setkey, encrypt ........ generate hashing encryption 
ctime(3C): ctime, localtime, 

gmtime, asctime, cftime, ascftime, 

MAKING, tZKCt sissscessessvrceasnesciacssses wee COnVErt date and time to string 
ctype(3C): isdigit, isxdigit, 

islower, isupper, isalpha, isalnum, 

isspace, iscntrl, ispunct, isprint, 

isgraph, isascii, tolower, toupper, 

toascci, _tolower, _toupper, 


setchrclass character handling 
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dev_to_ttyname(3C): dev_to_ttyname, 
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dial(3C) 
drand48(3C): drand48, erand48, 
lrand48, nrand48, mrand48, 
jrand48, srand48, seed48, lcong48 
ecvt(3C): ecvt, fevt, gcvt ... 
end(3C): end, etext, edata 
fpgetround(3C): fpgetround, 
fpsetround, fpgetmask, fpsetmask, 
f{pgetsticky, fpsetsticky 
frexp(3C): frexp, ldexp, modf 
ftw(3C) ... 
getcwd(3C) . 
getenv(3C) . 
getgrent(3C): getgrent, getgrgid, 
getgrnam, setgrent, endgrent, 
fgetgrent .... 
getlogin(3C) 
getopt(3C) ... 
getpass(3C) 
getpw(3C) ... 
getpwent(3C): getpwent, 

getpwuid, getpwnam, setpwent, 
endpwent, fgetpwent ....ssssseesereeneenes se 
getut(3C): getutent, getutid, 
getutline, pututline, setutent, 
endutent, utmpname, getutpid .... 
hsearch(3C): hsearch, hcreate, 
destroy sreecsseserseoveneers eenebeeee 
isnan(3C): isnand, isnanf . 
13tol(3C): 13tol, Itol3 .. 
Tock (BC) ..sscsesscssseserssees 
lsearch(3C): lsearch, lfind 
malloc(3C): malloc, free, realloc, 


memory(3C): memccpy, memchr, 
memcmp, memcpy, memset 
mkfifo(3C) 
mktemp(3C) 
monitor(3C) 
nlist(3C) ... 
perror(3C): perror, errno, 
sys_errlist, sys_nerr ... 
putenv(3C) 
putpwent(3C) . 
qsort(3C) 
rand(3C): rand, srand 
setjmp(3C): setjmp, longjmp 
Setlocale(3C) .....s.cssssssecssesseees 
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convert between major/minor numbers and tty names 


. establish an out-going terminal line connection 


. generate uniformly distributed pseudorandom numbers 
. convert floating-point number to string 
. last locations in program 


. IEEE floating-point environment control 
. manipulate parts of floating-point numbers 
. walk a file tree 


get pathname of current working directory 


. return value for environment name 


. get group file entry 

. get login name 

.. get option letter from argument vector 
. read a password 

. get name from UID 


get password file entry 


. access utmp file entry 


. manage hash search tables 


test for floating-point NaN (Not-A-Number) 
convert between 3-byte integers and long integers 
record locking on files 


. linear search and update 


main memory allocator 


«.. memory operations 
. make a FIFO special file 
. make a unique filename 
. prepare execution profile 
. get entries from name list 


. system error messages 

. change or add value to environment 
. write password file entry 

. quicker sort 

. simple random-number generator 


non-local goto 


. set programs location 
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sigsetjmp(3C): sigsetjmp, 
siglongjmp ... 
sleep(3C) .. 
ssignal(3C): ssignal, gsignal 
stdipc(3C) ..... 
strftime(3C) . 
string(3C): streat, strdup, strncat, 
strcmp, strncmp, strepy, strncpy, 
strlen, strehr, strrchr, strpbrk, 
strspn, strespn, strtok ... 
Btrstr(BC) ....ceccsesserseees 
strtod(3C): strtod, atof 
strtol(3C): strtol, atol, atoi 
swab(3C) 
tsearch(3C): tsearch, tfind, 
tdelete, twalk ..sesesssssseeen scant 
ttyname(3C): ttyname, isatty 
ttyslot(SC) c.rcscossccsecrseseeessserears 


.- non-local jumps 

suspend execution for interval 

software signals 

standard interprocess communication package 
.. format time information 


. string operations 

find first occurrence of character 

convert string to double-precision number 
convert string to integer 

.. Bwap bytes 


.. Manage binary search trees 
find name of a terminal 
.- find the slot in the utmp file of the current user 


38M Mathematical Library Routines 


bessel(3M): jO, jl, jn, yO, yl, yn ......... Bessel functions 

erf(3M): erf, erfe ... .. error function and complementary error function 
exp(3M): exp, log, log10, pow, sqrt .... exponential, logarithm, power, square root functions 
floor(3M): floor, ceil, fmod, fabs .. floor, ceiling, remainder, absolute value functions 


gamma(3M) ... .. log gamma function 
hypot(3M) .... Euclidean distance function 
matherr(3M) error-handling function 
sinh(3M): sinh, cosh, tanh ... .. hyperbolic functions 
trig(3M): sin, cos, tan, asin, acos, 

ALAD, ALADZ wa.rsrcereresrsceserscsscecereneerer Set trigonometric functions 


3N Networking Support Utilities 


t_accept(3N) 
t_alloc(3N) ... 
t_bind(3N) 

t_close(3N) .. 


.. accept a connect request 

allocate a library structure 

bind an address to a transport endpoint 
close a transport endpoint 


t_connect(3N) .. ... establish a connection with another transport user 
t_error(3N) . .. produce error message 

t_free(3N) .... free a library structure 

t_getinfo(3N) ... get protocol-specific service information 
t_getstate(3N) get the current state 

t_listen(3N) .. listen for a connect request 

t_look(3N) look at the current event on a transport endpoint 
t_open(3N) .. establish a transport endpoint 


t_optmgmt(3N) manage options for a transport endpoint 

t_rev(BN)  eeeseovee receive data or expedited data sent over a connection 
t_reveonnect(3N) receive the confirmation from a connect request 
t_revdis(3N) .... retrieve information from disconnect 

.. acknowledge receipt of an orderly release indication 
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t_revudata(3N) .... receive a data unit 
t_revuderr(3N) . Teceive a unit data error indication 
t_snd(3N) .. . send data or expedited data over a connection 


t_snddia(3N) . send user-initiated disconnect request 
t_sndrel(3N) ... . initiate an orderly release 
t_sndudata(3N) . send a data unit 

t_sync(3N) .... . synchronize transport library 
t_umbind(3N)  ......scsccssssssessssesssssssscscsassee disable a transport endpoint 


8PPS Sequent Parallel Programming Library 


intro(3PPS) 
brk(3PPS): brk, sbrk 
cpus_online(3PPS) . 
m_fork(3PPS) ..... 
m_get_myid(3PPS) 
m_get_numprocsa(3PPS) 


introduction to Parallel Programming Library 
. change private data segment size 

. returns the number of CPUs on-line 

. execute a subprogram in parallel] 

. return process identification 

. return number of child processes 


m_kill_procs(3PPS) ....... . kill child processes 

m_lock(3PPS): m_lock, m_unlock ...... lock, unlock locks 

M_NEXU(BPPS) recsesssscsssessssenssersseessnsssseees increment global counter 
m_park_procs(3PPS): m_park_procs, 

m_rele_procs suspend and resume child process execution 


m_set_procs(3PPS) 
m_single(3PPS): m_single, - 


set number of child processes 


m_multi mark single-process code section 
m_sync(3PPS) .. check in at barrier 
s_lock(3PPS): s_init_lock, s_lock, 

s_clock, s_unlock .... . initialize, lock, unlock locks 


8_wait_barrier(3PPS): 
s_wait_barrier 
shbrk(3PPS): shbrk, shsbrk 
shmalloc(3PPS): shmalloc, 

Bhrealloc, shfree .....sssssssssssscecssessscessese shared memory allocator 


initialize barrier, wait at barrier 
change shared data segment size 


3S Standard I/O Library Routines 


ctermid(3S) ... 
cuserid(3S) ... 
fclose(3S): fclose, flush 
ferror(3S): ferror, feof, clearerr, 

GOR ssessscsssssscsesesssccassusscasesvonsacsabesesesicsass stream status inquiries 

fopen(3S): fopen, freopen, fdopen . open a stream 

fread(3S): fread, fwrite .......00 . binary input/output 

feeek(3S): feeek, rewind, ftell . reposition a file pointer in a stream 
getc(3S): getc, getchar, fgetc, getw .... get character or word from a stream 
gets(3S): gets, fgets . get a string from a stream 
popen(3S): popen, pclose . initiate pipe to/from a process 
print{(3S): printf, fprintf, sprintf ....... print formatted output 


generate filename for terminal 
. get character login name of the user 
. close or flush a stream 
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pute(3S): putc, putchar, fputc, 
putw 
puts(3S): puts, fputs . 
scan{(3S): scanf, fecanf, sscanf .. 
setbuf(3S): setbuf, setvbuf .. 
stdio(3S) ... 


put character or word on a stream 

put a string on a stream 

.. convert formatted input 

. assign buffering to a stream 

. standard buffered input/output package 


system(3S) . issue a shell command 

tmpfile(3S) .... . create a temporary file 

tmpnam(3S): tmpnam, tempnanm ...... create a name for a temporary file 

UNGELC(BS) vrsrsesssesesssssssecscseseseeneeeeseseensees push character back into input stream 
vprint{(3S): vprintf, vfprintf, 

vsprintf .. print formatted output of a varargs argument list 


8SEQ Sequent I/O Library Routines 


dis386(3SEQ) . disassemble Series 386 instructions 
getgeombyname(3SEQ) . get disk geometry by name 
getmntent(3SEQ): addmntent, 

endmntent, getmntent, 

hasmotopt, setmntent ... .. get file system descriptor file entry 
getpseudotty(3SEQ) .. get pseudo terminals 
getscsiinfo(3SEQ): getscsiinfo, 

BOLACSIMALCH ascssvesssscesvesssnssnssnsersnesvonsensin get scsiinfo structure 
getusclk(3SEQ): getusclk, 

WSCIE Gt sascscsssssssvesssesssoscecoceesssssvavavenssts get/init microsecond clock 
getzdinfo(3SEQ): getzdinfo, 

getzdinfobyname ..... .. get zdinfo structure 


initgroups(3SEQ) 
nblocks(3SEQ) ..... 


initialize group access list 
.. calculate number of blocks and indirect blocks 


offline_all(3SEQ) .. take all but one active processor off line 
read_constab(3SEQ) . .. read constab entries into a structure 
valloc(3SEQ) ... .. aligned memory allocator 


8X Special Routines 


assert(3X) .... .. verify program assertion 
crypt(3X) . .. password and file encryption functions 
curses(3X) .... .. terminal screen handling and optimization package 


directory(3X): opendir, readdir, 

telldir, seekdir, rewinddir, closedir .... directory operations 

getspent(3X): getspent, getspnam, 

setspent, endspent, fgetspent, 

Ickpwdf, ulckpwdf ....sssessssssecsesssseenessenes get shadow password file entry 

ldahread(3X) .. read the archive header of a member of an archive file 

Idclose(3X): Idclose, Idaclose . .. Close a common object file 

Idfhread(3X) ....... .. read the file header of a common object file 

ldgetname(3X) .... .. retrieve symbol name for common object file symbol 
table entry 
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ldlread(3X): Idlread, Idlinit, ldlitem .. manipulate line number entries of a common object 
file function 

ldlseek(3X): Idlseek, ldnlseek........... .... seek to line number entries of a section of a common 

object file 

seek to the optional file header of a common object file 

open a common object file for reading 

. seek to relocation entries of a section of a common 
object file 

ldshread(3X): ldshread, ldnshread .... read an indexednamed section header of a common 

object file 

seek to an indexednamed section of a common object file 

compute the index of a symbol table entry of a 

common object file 


Idohseek(3X) ... 
Idopen(3X): Idopen, Idaopen 
Idrseek(3X): ldrseek, ldnrseek .. 


ldsseek(3X): ldsseek, ldnsseek 
ldtbindex(3X) . 


ldtbread(3X) ... .. read an indexed symbol table entry of a common object file 
ldtbseek(3X) .. seek to the symbol table of a common object file 
logname(3X) .. return login name of user 


malloc(3X): malloc, free, re: 
calloc, mallopt, mallinfo 
ndbm(3X): dbm_open, dbm_close, 
dbm_fetch, dbm_store, 
dbm_delete, dbm_firstkey, 
dbm_nextkey, dbm_error, 
dbm_clearerr, dmb_blkflush . 
plot(3X) «ss 
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regcmp(3X): regemp, regex ... 
sputl(3X): sputl, sgetl . 
utadduser(3X): ut_add_user, 

ut_delete_user «sss acnasbausascasousessnd .... add/delete users in utmp file 


fast main memory allocator 


. database subroutines 

graphics interface subroutines 

write shadow password file entry 

compile and execute regular expression 

. access long integer data in a machine-independent fashion 


4 File Formats 


intro(4) .... .. introduction to file formats 

a.out(4) . common assembler and link editor output 
acct(4) ... per-process accounting file format 
addusr_def(4) . add user defaults 

alias(4) .. alias file for FACE 


. see C and Language Tools Binder 
backup cycle code definitions 
backup subcode definitions 


backup_codes(4) 
backup_codes1(4) 
backup_dev(4) backup devices 
backup_info(4) backup set definitions 
sian language specific strings 
list of filesystems processed by fsck and ncheck 
constructed devices table 
format of core image file 
format of cpio archive 
.. cron history file 
.. clock daemon file 
.. Virtual device table 


crontabs(4) .. 
devtab(4) ..... 
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.. file system independent directory entry 
.. disk device characteristic database 
incremental dump format 

FACE files 


dump(4): dump, dumpdates 
env(4): .environ, .pref, .variables 


errorlog(4) . internal error log file 

errormsg(4) error message text file 

filehdr(4) «0... file header for common object files 

fs(4): fs, inode . format of file system volume 

fepec(4) .. format specification in text files 

fstab(4) .. file-system-table 

gettydefs(4) speed and terminal settings used by getty 
gps(4): gps .. graphical primitive string, format of graphical files 
group(4) . .. group file 

helplog(4) monitor help actions 

init.d(4) . system level transition files directory 

inittab(4) script for the init process 

issue(4) .. issue identification file 

Idfen(4) .. common object file access routines 

limits(4) file header for implementation-specific constants 


linenum(4) .... line number entries in a common object file 
loginlog(4) . log of failed login attempts 

Iptypes(4) table of printer types supported by the menu system 
mnttab(4) mounted filesystem table 


mod_config(4) format of a module configuration file 

motd(4) ... message-of-the-day file 

ott(4) ... files that hold object architecture information 
passwd(4) password file 

plot(4) .... graphics interface 

product(4) . installed products file 

profile(4) .. setting up an environment at login time 
proto(4) .. prototype job file for at 

Te(4) se reboot and shutdown command scripts 
resfile(4) format of RCS file 

reloc(4) .. relocation information for a common object file 
scecsfile(4) format of SCCS file 

senhdr(4) ... section header for a common object file 
scr_dump(4) . .. format of curses screen image file 

shadow(4) .. .. Testricted password file 

shells(4) ..... shell table 

shutdown(4) system shutdown information file 

spellhist(4) unmatched spelling words file 

sulog(4) .. log of substitute user events 

syms(4) .. common object file symbol table format 
sys_config(4) format of a system configuration file 
syskeymap(4) identify keys to internal menu system functions 
task(4) ... global security table 

term(4) .. format of compiled term file 

termcap(4) terminal capability data base 

terminfo(4) .... .. terminal capability database 
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timmeZone(4) ...ssscsccerorerseseesesssssstersesersteese set default system time zone 
UMIStA(A) sececcsssssesrerneen = ... file header for symbolic constants 
utmp(4): utmp, wtmp . utmp and wtmp entry formats 
UWUCH4)  ereseees sscasecesussenncee .. networking support files 


5 Miscellaneous 


intro(5) . introduction to miscellany 
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user environment 

file control options 

math functions and constants 
profile within a function 

regular expression compile and match routines 
.. data returned by stat system call 
. conventional names for terminals 
primitive system data types 
machine-dependent values 
handle variable argument list 


values(5) .. 
varargs(5) 


7 Special Files 


intro(7) ..... .. introduction to special files 

clone(7) . wwe. Open any minor device on a STREAMS driver 
cmpt(7) . .. compatibility partitioning driver 

cn(7) .. . pseudoconsole driver 


consmem(7): consmem, sm, 88 console memory drivers 
CONSONE(T)  seesssssecssessnsseeeneereren sss CONSOle interface 
kmmem(7): kMBmem, kMWmem ..... MULITBUS memory 


1d0(7) .... .. STREAMS tty line discipline 

log(7) interface to STREAMS error logging and event tracing 
1p(7) .. Systech parallel line printer interface 

Ipmod(7) parallel printer canonical processing module 
mbad(7) ...... MULITBUS adapter 

mem(7): mem, kmem core memory 

mtio(7) ... UNIX magnetic tape interface 

null(7) ... .. the null file 

pmap(7) .. Map physical addresses into processs virtual address 


space 
devices administered by System Administration 

.. SCSI/Ethernet/Diagnostics board 

SCSI disk controller 

STREAMS pipe device 

System Services Module 

Systech MTI-800/1600/1650 terminal multiplexor driver 
STREAMS ioct] comimands 


streampty(7) STREAMS pseudo terminal driver 
streamtty(7) Generic STREAMS tty driver interface 
termio(7) general terminal interface 

tg(7) .- SCSI 1/2-inch magnetic tape interface 
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timod(7) .... .. Transport Interface cooperating STREAMS module 
tirdwr(7) ... .. Transport Interface read/write interface STREAMS module 
tm(7) .. .. SCSI tape controller 

ts(7) . SCSI tape controller 

tty(7) .. controlling terminal (gentty) interface 

usclk(7) 32-bit microsecond counter 
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8 Stand-Alone Utilities 


HNtTO(B) . secsccsesescsesevcsnssssssussevccnsassseseessnavese introduction to system standalone utilities 

ecsformat(8) . ... standalone embedded SCSI disk formatter 

boot(8) .. run a standalone program or bring up the operating 
system 


copy(8) ... .. perform a standalone data transfer 

dump(8) . standalone memory dump 

PIEVEOC(B)  ..secesseees print the VTOC of a standalone disk device 

zdformat(8) ..... .. standalone disk formatter for dual-channel disk controller 
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DASI 300 and 300sterminals 300, 
special functions of DASI 300 and 
usclk: 
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setgroups: set group 
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turnacct: shell procedures for 
runacct: run daily 

/accton, acctwtmp: overview of 

of accounting and miscellaneous 
diskusg: generate disk 

acct: per-process 
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1650 terminal multiplexor driver... 
2645A terminal tape file archiver. 
300, 300s: handle special functions. 
300 and 300s terminala................ 
300s: handle special functions of.. 
3008 terminals.......sssssesseee 


-300(1) 
-300(1) 
-300(1) 
-300(1) 


32-bit microsecond counter.. -usclk(7) 
386 instructionS.........s000 ..dis386(3SEQ) 
450: handle special functions of the +10450(1) 
450 terminal 450(1) 
472 MULITBUS magnetic tape in’ i 

64 ASCII String......csssssssssssseessees 


781 terminal multiplexor driver.. 
a64l, 164a: convert between long.. 
abort: generate an IOT fault...... 
abs: return integer absolute value... 
absolute value... 
absolute value functions.. 
accept a connect request... 
accept, reject: allow or prevent LP. 
access and modification timez...... 
access and modification times of a file 
access: determine accessibility of a. 
access list... 
access list .. 
access long integer data in a.. 
access routines... 
access utmp file entry.... 
accessibility of a fil 
accounting 
accounting. 
accounting.. 
accounting. 
accounting.... 
accounting and miscellaneou: 
accounting commanda.......... 
accounting data by user ID... 
accounting file format... 
accounting files... 
accounting files... 
accounting records.. 
accounting records. 
acct: enable or disable process.. 
acct: per-process accounting file... 
acctems: command summary from... 
acctcom: search and print process. 
acctcon1, acctcon2: connect-time 


+8641(3C) 
meee 


“acetcon( 1M) 
.acctpre( 1M) 
..acctsh(1M) 
runacct(1M) 
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acctconl, 

acctwtmp: overview of accounting/ 
of accounting and/ acctdisk, 
accounting files 

acctdisk, acctdusg, 

accounting 

acctprel, 

acctdisk, acctdusg, accton, 

release indication t_revrel: 
trig: sin, cos, tan, asin, 

helplog: monitor help 

sigaction: examine and change signal 
killall: kill all 

offline_all: take all but one 
mbad: MULITBUS 

addcmdopt: 

addformopt: 

addmenuopt: 

acctmerg: merge or 
addusr.def: 

putenv: change or 

menu 

ut_add_user, ut_delete_user: 
option to a menu 

menu 

hasmntopt, setmntent: get file/ 
map an open file into the processs 
munmap: unmap part of the processs 
addresses into processs virtual 
t_bind: bind an 

pmap: map physical 


menu 


files 

print service Ipfilter: 
print service Ipforms: 
admin: create and 

SA: devices 


SA: devices administered by System 
sysadm: menu interface to do system 
uadmin: 

uadmin: 

swap: swap 

/usr/ 

/onproc: run a command with priority 
alarm: set a process 


/display application specific 
pathalias: 

valloc: 

t_alloc: 

brk, sbrk: change data segment space 
free, realloc, calloc: main memory 


acctcon2: connect-time accounting. 
acctdisk, acctdusg, accton...... 
acctdusg, accton, acctwtmp: overvie' 
acctmerg: merge or add total 


...acctpre(1M) 
acctpre(1M) 
....acct(1M) 
.t_revrel(3N) 
.trig(3M) 
. hel plog(4) 
.-Sigaction(2) 
killall(1M) 
offline_all(3SEQ) 


acctprel, acctpre2: process. 
acctpre2: process accounting. 
acctwtmp: overview of accounting and/ 
acknowledge receipt of an orderly.. 
acos, atan, atan2: trigonometric/ 
actions... 
actions.. 
active processes. 
active processor off lin 


BOO Pers saccacooscusccscconcssnassencsacisecorsdssiesscsendsoassisssencseasasail mbad(7) 
add a command option to a menu... addcemdopt(1M) 
add a form/SELECT window option to a.....addformopt(1M) 
add a menu option to a menu addmenuopt(1M) 
add total accounting files acctmerg(1M) 
add user defaults addusr_def(4) 
add value to environment.. ..putenv(3C) 
addcmdopt: add a command option to a.....addemdopt(1M) 
add/delete users in utmp file utadduser(3X) 


addformopt: add a form/SELECT window...addformopt(1M) 
addmenuopt: add a menu option to a addmenuopt(1M) 
addmntent, endmntent, getmntent,... 
address space.. 
address space.. 
address space.. 
address to a transport endpoint... 
addresses into processs virtual address space 
addusr.def: add user defaults addusr_def(4) 


admin: create and administer SCCS ..admin(1) 
administer filters used with the LP pfilter(1M) 
administer forms used with the LP. .lpforms(1M) 
administer SCCS files .......c:scsssseseeseee admin(1) 


.8a(7) 
...8a(7) 
.sysadm(1) 
-uadmin(1M) 
.uadmin(2) 
..8wap(1M) 
-loginlog(4) 
.noage(1M) 


administered by System Administration. 
Administration... 
administration... 
administrative control. 
administrative control 
administrative interface. 
adm/loginlog: log of failed login attempts 
aging, PFF, swapping, or processor‘. 
Alarm CLOCK ....ssssssssseescsessesssrereserees 
alarm: set a process alarm clock .. 
alarms and/or the working indicator... 
alias file for FACE....ssseee 
aligned memory allocator.. 
allocate a library structure... 
allocation.. 
allocator... 
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mallopt, mallinfo: fast main memory 
shrealloc, shfree: shared memory 
valloc: aligned memory 

editor output 

to maintenance commands and 

the working/ indicator: display 
lookup 


and libraries 

be: 

ott: files that hold object 

cpio: format of cpio 

the archive header of a member of an 
ar: common 

ldahread: read the 
2645A terminal tape file 
tar: tape file 

cpio: copy file 

varargs: handle variable 
print formatted output of a varargs 
xargs: construct 

getopt: get option letter from 

echo: echo 

expr: evaluate 

message: puts its 

be: arbitrary-precision 

asa: interpret 

characters 

Nocaltime, gmtime, asctime, cftime, 
ascii: map of 


archive file 


between long integer and base-64 
ctime, localtime, gmtime, 

trig: sin, cos, tan, 

as: common 

a.out: common 


assert: verify program 

system commands 

/program for generating/modifying 
assist: 

generating/modifying ASSIST menus/ 
later time 

trig: sin, cos, tan, asin, acos, 

/sin, cos, tan, asin, acos, atan, 
double-precision number strtod, 
strtol, atol, 

strtol, 

change login password and password 
control over various process 

res: change RCS file 

dumpconf: dump kernel 
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allocator ..8hmalloc(3PPS) 
allocator. valloc(8SEQ) 
a.out: common assembler an an out(4) 
application programe ........ssecsesseee 
application specific alarms and/or 
apropos: locate commands by keyWord.....sssessosee apropos(1) 


..see C and Lang Tools Binder 
...8ee C and Lang Tools Binder 
.-be(1) 


ar: archive file format... 
ar: maintain archives... 
arbitrary-precision arithmetic language... 


epio(4) 
oe dahread(3X) 
and i Tools Binder 


ATCHIVEL ...essseeessereees 
archives in and out 
argument list... 
argument list... 
argument list(s) and execute command... 
argument vector... 
arguments... 
arguments as an expression 
arguments on message line.. 
arithmetic language 
ASA carriage control characters.... 
asa; interpret ASA carriage contro. 
ascftime, mktime, tzset: convert... 
ASCII character set... 
ascii: map of ASCII character set. 
ASCII String....ccsssessssssssesseeeseessees 
asctime, cftime, ascftime, mktime, tzsety 
asin, acos, atan, atan2: trigonometric/.... 

ASSEMDIEL.....0ccecsecsscscrernsovsonsees see Cand Lang Tools Binder 
assembler and link editor oUtput.....c.ccsssscsseersesseoes a.out(4) 
assert: verify program assertion 
ASSCITION .escssseesseseseeseeeseeeeeenestes 
assist: assistance using operating.. 
ASSIST menus or command forms.. 
assistance using operating system commani 
astgen: program for. 
at, batch: execute commands at a... 
atan, atan2: trigonometric functions 
atan2: trigonometric functions. 
atof: convert string t0.......s00 
atoi: convert string to integer.. 
atol, atoi: convert string to integer. 
attributes... 
attributes 
attributes. 
auto-configuration device table... 


.ascii(5) 
.ascii(5) 
.-8641(3C) 


“dumpeanil 1M) 
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language 

backup.codes: 

backup.dev: 

ckbupscd: check filesystem 
backup.info: 
backup.codes1: 

definitions 

definitions 


m_syne: check in at 
initialize barrier, wait at 
/s_wait_barrier: initialize 
of pathnames 

at, 

language 

procedures 


bessel: jO, j1, jn, yO, yl, yn: 
Bessel functions 


fread, fwrite: 

bp: 

bsearch: 

tfind, tdelete, twalk: manage 
tmp_affinity: 

t_bind: 

sum: print checksum and 

prtvtoc: print the VTOC of a 
sigprocmask: examine and change 
number of blocks and indirect 
nblocks: calculate number of 

df: report number of free disk 
consistency check based on the 
consistency check based on the BOM 
bootflags: display/change system 
installboot: installs a 

bring up the operating system 
boot flags 


allocation 

segment size 

table 

stdio: standard 
setbuf, setvbuf: assign 
mailbug: submit a 
devbuild, devdestroy: 
secstorcs: 

mknod: 


awk: pattern scanning and processing. 

backup cycle code definitions.. .-backup_codes(4) 
backup devices... -backup_dev(4) 
backup schedule .. ...ckbupsed(1M) 
backup set definitions... -backup_info(4) 
backup subcode definitions.. backup_codes1(4) 
backup.codes: backup cycle code ..backup_codes(4) 


backup_codes1(4) 
..backup_dev(4) 
-backup_info(4) 


backup.codes1: backup subcode... 
backup.dev: backup devices 
backup.info: backup set definitions. 
banner: make posters. 


DATTICT.....scsseeseee ..m_synce(3PPS) 
barrier......... s_wait_barrier(3PPS) 
barrier, wait at barrier. s_wait_barrier(3PPS) 
basename, dirname: deliver portions .basename(1) 


oo At(1) 
webe(1) 
checkre( 1M) 
«bdflush(1M) 
ania 


batch: execute commands at a later time. 
be: arbitrary-precision arithmetic. 
bcheckre: system initialization 
bdflush: update daemon... 
bdflush: update daemon. 
bdiff: big diff. 
Bessel functions... 
bessel: j0, jl, jn, yO, yl, yn 
bfs: big file scanner.... 
binary input/output. 
binary patcher........ 
binary search a sorted table 
binary search trees... 
bind a process to a processor... 
bind an address to a transport endpoint. 


tmp_affinity(2SEQ) 
.t_bind(3N) 


block count of a file.. .-3um(1) 
block device..... prtvtoc(1M) 
blocked signals -Sigprocmask(2) 
DIOCKS ..ssscssecesese -nblocks(3SEQ) 
blocks and indirect blocks. -nblocks(3SEQ) 
blocks and inodeB.......secersesscssererscssssstscnsrssseseseeneaceesees df(1M) 


BOM... -bomverify(1M) 


bomverify: -bomverify(1M) 
DOOt flags......sssesersessvereeen bootflags(1M) 
boot program on a disk.. installboot(1M) 
boot: run a standalone program OF...ssssssesessercressceerees boot(8) 
bootflags: display/change system bootflags(1M) 
bp: binary patcher.......ssssssescseessee .bp(1M) 


brk, sbrk: change data segment epee’ 
brk, sbrk: change private data... 
bsearch: binary search a sorted... 


~-brk(3PPS) 
bsearch(3C) 


buffered input/output package ....8tdio(3S) 
buffering to a stream... setbuf(3S) 
bug report or enhancement request. mailbug(1) 
build and destroy virtual devices... devbuild(1M) 
build RCS file from SCCS file scestores(1) 
build special file. ...mknod(1M) 
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config: 

swab: swap 

ce: 

cflow: generate 


exref; generate a 
ctrace: 
list: produce 


nblocks: 
dc: desk 
cal; print 


indirect blocks 


stat: data returned by stat system 
syscall: indirect system 

cu: 

malloc, free, realloc, 

malloc, free, realloc, 

introduction to Sequent system 
intro: introduction to system 

Ip, cancel: send/ 

LP print service lp, 
Ipmod: parallel printer 
description into a terminfo/ 
asa; interpret ASA 


gence: create a front-end to the 
disk formatter 


an SCCS delta 
remainder, absolute value/ floor, 
floor, ceil, fmod, fabs: floor, 


ctime, localtime, gmtime, asctime, 


sigprocmask: examine and 
brk, sbrk: 
passwd: 
chmod: 
chmod: 
putenv: 
chown: 
chown, chgrp: 
nice: 

brk, sbrk: 
res: 

chroot: 
chroot: 


attributes 
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C flowgraph.... ..see C and Lang Tools Binder 
C language preprocessor........see C and Lang Tools Binder 
C program beautifier.. ..see C and Lang Tools Binder 
C program checker...... gee C and Lang Tools Binder 
C program cross-reference.....see C and Lang Tools Binder 
C program debugger. see C and Lang Tools Binder 
C source listing..... 

ca]: print calendar... 

calculate number of blocks and. 

calculator... 


call another UNIX system... 
calloc: main memory allocator.. 


cancel: send/cancel requests to the. 
canonical processing module... 
captoinfo: convert a termcap. 
carriage control characters.... 
cat: concatenate and print files. 


cb: C program beautifier see ng 

CO COMM ANG sisccssescscccccannsttcasacecesasencaesnaseccaiensarscat ou gence( 1M) 
cc: C compiler... .see C and Lang Tools Binder 
CCSformat: standalone embedded SCSI...........ccsformat(8) 


cd: change working directory.........« on 
cde: change the delta commentary of. 
ceil, fmod, fabs: floor, ceiling,.......... 
ceiling, remainder, absolute value/ 
cflow: generate C flowgraph...see C and Lang Tools Binder 
cftime, ascftime, mktime, tzset//.. .ctime(3C) 
cftime: language specific strings. . 

change blocked signals...........100 
change data segment space allocation 
change login password and password 
change mode......... 
change mode of file 
change or add value to environment.. 
change owner and group of a file... 
change owner or group........ 
change priority of a process. 
change private data segment size 
change RCS file attributes.. 
change root directory.......... 
change root directory for a command. 
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shbrk, shsbrk: 

sigaction: examine and 
bootflags: display/ 

shutdown: shut down system, 


change shared data segment 8iZ€ .........sssseeeeee shbrk(3PPS) 
change signal actions......cssssssssesscssssseeearereeessoes sigaction(2) 
change system boot flags... 

change system state 


ede: change the delta commentary of an SCCS delta, Léebiseied ede(1) 
newform: change the format of a text file... ...newform(1) 
helpadm: change the Help Facility database. helpadm(1M) 
rename: change the name of a file.. -rename(2) 
delta: make a delta( change) to an SCCS file ......sssssssssseseessssseesesorsenseeseerens delta(1) 
parameters vm_ctl: examine and change virtual memory tuning m_ctl(2SEQ) 
cd: change working directory... ...cd(1) 

chdir: change working directory i 

pipe: create an interprocess channel..........-scsersss 


zd: dual- 
standalone disk formatter for dual- 
strstr: find first occurrence of 


ungetc: push 

conversion tables _chrtbl: generate 
_tolower, _toupper, setchrclass: 
cuserid: get 


getc, getchar, fgetc, getw: get 
putc, putchar, fputc, putw: put 
ascii: map of ASCII 

fgrep: search a file for a 

diskinfo: disk device 

asa: interpret ASA carriage control 
_tolower, toascii: translate 

tr: translate 

lastlogin, monacct, nulladm/ 


filesystem directory consistency 
filesystem storage consistency 
checkfsys: 


channel disk controller.. 
channel disk controller... 


‘ungete(3S) 
.chrtbl(1M) 


character back into input stream... 
character classification and. 
character handling... 
character login name of the user, 
character or word from a stream, 
character or word on a stream 
character set. 
character string.. 


characteristic database. diskinfo(4) 
CHATACtCTS....ccscssessssscerssercsssssssseccccossnscasscesssnsssnsecssosssneees asa(1) 
characters . conv(3C) 
characters...» ww tr(1) 
chargefee, ckpacct, dodisk 

chdir: change working directory .......ssssscssssssensesoens chdir(2) 
CHECK ..ssseceessees echantes dcheck(1M) 
CROCK sacocresnnsrnssesanss icheck(1M) 


check a filesystem 


fsck: filesystem consistency check and interactive rePAir.....sscssssesssrsererseesseesnes fsck(1M) 
perform an installation consistency check based on the BOM....... -bomverify(1M) 
checkeq: check documents for correct eqn syntax ....checkeq(1) 

ckbupsed: check filesystem backup schedule. ..ckbupsed(1M) 

m_syne: check in at barrier...... aaa: 

ci: check in RCS revisions. -ci(1) 


co: 
uucheck: 
eqn syntax. 


permissions file 


processed by fsck and ncheck 

sum: print 

chown, 

/m_rele_procs: suspend and resume 
times: get process and 

wait, waitpid: wait fora 
m_get_numprocs: return number of 
m_kill_procs: kill 


m_set_procs: set number of 


check out RCS revisions.. 
check the uucp directories and........ 
checkeq: check documents for correc 
checkfsys: check a filesystem... 


...checkeq(1) 


checklist: list of filesystems... hecklist(4) 
checksum and block count of a file .....s.sersersoessereessers sum(1) 
chgrp: change owner or group. ...chown(1) 
child process execution.. -m_park_ procs(3PPS) 
child process times...... .times(2) 
child process to stop or terminate... ..wait(2) 
child processes. m_get_ numprocs(3PPS) 


...m_kill_procs(3PPS) 


child processes. 
....m_set_procs(3PPS) 


child processes. 
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command 
classification and conversion/ 


schedule 

nulladm, pretmp/ chargefee, 
chrtbl: generate character 

elri: 


ferror, feof, 

a shell (command interpreter) with 
alarm: set a process alarm 
usclk_init: get/init microsecond 
cron: 

crontabs: 


STREAMS driver 
Idclose, Idaclose: 
close: 

t_close: 


fclose, fflush: 
/telldir, seekdir, rewinddir, 


driver 


communicate to a/ cocreate, cosend, 
coreceive, codestroy: communicate/ 
backup.codes: backup cycle 
m_multi: mark single-process 
/cosend, cocheck, coreceive, 


to form error log dmesg: 
setcolor: redefine or create a 


comb: 

to two sorted files 

mes: manipulate the object file 
cde: change the delta 

aout: 

Idclose, Idaclose: close a 

Idfhread: read the file header of a 
number entries of a section of a 
to the optional file header of a 
relocation entries of a section of a 
indexednamed section header of a 
to an indexednamed section of a 
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chmod: change mode.... 
chmod: change mode of file. 
chown: change owner and group of a... 
chown, chgrp: change owner or group 
chroot: change root directory... 
chroot: change root directory for a... 
chrtbl: generate character .. 
ci: check in RCS revisions... 
ckbupscd: check filesystem backup... 
ckpacct, dodisk, lastlogin, monacct,... 


classification and conversion tables. ~ chrtbl( 1M) 
ClO AT ING vs cosececesassnexcasctusescescaveseavsveee .»clri(1M) 
clearerr, fileno: stream status inquiries ferror(3S) 
C-like syntax.. csh(1) 
clock... larm(2) 
clock.. -getusclk(3SEQ) 
CLOCK AS CIM Oia sessecesccssecesssscnscssssnasascseaseavteseseaptanibeaesel cron(1M) 
clock daemon file... crontabs(4) 
clock: report CPU time use: clock(3C) 
clone: open any minor device on a 


close a common object fil 
close a file descriptor... 
close a transport endpoint... 
close: close a file descriptor 
close or flush a stream........ 
closedir: directory operations. 
clri: clear inode 
cmp: compare two files. fl 
cmpt: compatibility partitioning.. cempt(7) 
cn: pseudoconsole driver..... 
co: check out RCS revisions. 
cocheck, coreceive, codestroy: 
cocreate, cosend, cocheck,, = 
code definitions backup_codes(4) 
code section. 
codestroy: communicate to a proces coproc(1F) 
col: filter reverse line-feeds......ssssesssessssssereesernsneseseens col(1) 
collect system diagnostic messages... 
color... 


comb: combine comb(1) 
combine SCCS deltas........... comb(1) 
comm: select or reject lines common. ..comm(1) 


comment section... 


commentary of an SC ..cde(1) 
common assembler and link editor output. a.out(4) 
common object file..... -ldclose(3X) 


..ldfhread(3X) 
...1dlseek(3X) 
-ldohseek(3X) 
Jdrseek(3X) 
.ldshread(3X) 
...ldsseek(3X) 


common object file 
common object file.... 
common object file. 
common object file. 
common object file. 
common object file........ 
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index of a symbol table entry of a 

an indexed symbol table entry of a 
seek to the symbol table of a 
linenum: line number entries in a 
reloc: relocation information for a 
senhdr: section header for a 

ldfcn: 

Idopen, Idaopen: open a 

/manipulate line number entries of a 
ldgetname: retrieve symbol name for 


sym: 
filehdr: file header for 

symbols glossary: definitions of 
comm: select or reject lines 

cocheck, coreceive, codestroy: 
ipes: report inter-process 

stdipe: ftok: standard interprocess 
tfipe: interprocess 
infocmp: 

resdiff: 

cmp: 

secsdiff: 

diff: differential file 
diff3: 3-way differential file 

dircmp: directory 

cmpt: 

regemp: regular expression 

regcmp, regex: 

regexp: regular expression 

term: format of 

ce: C 

ec: forms 

tic: terminfo 

yace: yet another compiler- 

yace: yet another 

erf, erfc: error function and 

" cprs: 
compress, uncompress, zcat: 

pack, peat, unpack: 

and expand data 

entry of a common object/ ldtbindex: 
cat: 

test: 

files 

pathconf, fpathconf: get 

sysconf: get 

dumpconf: dump kernel auto- 
mod_config: format of a module 
sys_config: formatof a system 

config: build system 

showefg: show the 

Ipadmin: 


descriptions 


common object file... ...ldtbindex(3X) 
common object file .ldtbread(3X) 
common object file .Idtbseek(3X) 
common object file -linenum(4) 


common object file .-reloc(4) 
common object file... 
common object file access routines. 


common object file for reading "Idopen(3X) 


common object file function.. ...ldlread(3X) 
common object file symbol table/ .ldgetname(3X) 
common object file symbol table forma’ ..syms(4) 


common object files 
common operating system terms and 
common to two sorted files... 
communicate to a process... 
communication facilities status.. 
communication package... 
communication reporter... 
compare or print out terminfo. 
compare RCS revisions 
compare two files......... 
compare two versions of an SCCS file 
comparison. 
comparison. 
comparison.. 
compatibility partitioning driver 
COMPILE ..sesssessesssenssceseneeserseeteseseeneen 
compile and execute regular expression... 
compile and match routines., 
compiled term file... 
compiler... 
compiler 
compiler.... 
COMPILET.......sseeeeeeee 
compiler-compiler 
complementary error function. a 
compress an object file... .see C and Lang Tools Binder 
compress and expand data, 
compress and expand files 
compress, uncompress, zcat: compress. 
compute the index of a symbol table 
concatenate and print files...... 
condition evaluation command... 
config: build system configuration. 
configurable pathname variables... 
configurable system variables 
configuration device table......... 


‘pathcon{t2) 
..syscon{(2) 
.-dumpceonf(1M) 


configuration file... mod_config(4) 
configuration file ..sys_config(4) 
configuration files. ..config( 1M) 
configuration of the machine ..showcfg(1M) 
configure the LP print service... .--.]padmin(1M) 
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t_reveonnect: receive the 

fwtmp, wtmpfix: manipulate 
t_accept: accept a 

t_listen: listen for a 

receive the confirmation from a 
establish an out-going terminal line 
data or expedited data sent over a 
send data or expedited data over a 
t_connect: establish a 

acctcon1, acctcon2: 

dcheck: filesystem directory 
icheck: filesystem storage 

feck: filesystem 

bomverify: perform an installation 
quotacheck: filesystem quota 
drivers 


console: 
consmem, 8m, 88: 


read_constab: read 

header for implementation-specific 
math: math functions and 

unistd: file header for symbolic 
constab: 

deroff: remove nroff, tbl, and eqn 
Uutry: try to 

Is: list 

sigcontext: get signal 

set and/or get signal stack 

csplit: 

sd: SCSI disk 

tm: SCSI tape 

ts: SCSI tape 

wd: SSM SCSI disk 

zd: dual-channel disk 

disk formatter for dual-channel disk 
synchronize a co-process with the 


virtually hangup the specified 

tty: 

_tolower, toascii: translate/ 

units: 

character classification and 

terminfo description captoinfo: 
dd: 

long integers 13tol, ltol3: 


base-64 ASCII string a64]l, 164a: 
dev_to_ttyname, ttyname_to_dev: 
/cftime, ascftime, mktime, tzset: 
ecvt, fevt, gevt: 

scanf, fecanf, sscanf: 

strtod, atof: 
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confirmation from a connect request... 
connect accounting records 


__accept(3N) 

.t_listen(3N) 

__reveonnect(3N) 

connection. .-.-dial(3C) 
connection. _rev(3N) 


.t_snd(3N) 
.t_connect(3N) 
acctcon(1M) 
.dcheck(1M) 


connection. 
connection with another transport user 
connect-time accounting... 
consistency check... 
consistency check 
consistency check and inter: 
consistency check based on the BOM 
consistency Checker.....ccssssssssesesesees 
consmem, 8m, 8s: console memory 
console: console interface . 
console interface.......ss00« 
console memory drivers 
constab: constructed devices table. 
constab entries into a structure 


bomverify(1M) 
quotacheck(1M) 
consmem(7) 
console(7) 
console(7) 


read. constab(3SEQ) 


CONSEAN EB ce sisscsacscrsssideceasesossieces issn limits(4) 
constants... oat sree math(5) 
constants... ..unistd(4) 
constructed devices table.. constab(4) 
constructs... deroff(1) 
contact remote system with debugging on. 

contents of directory or 
context... “sigcontext(2SEQ) 
context... -8igstack(2SEQ) 
context split .. csplit(1) 
controller... .8d(7) 
controller tm(7) 
controller ..ta(7) 
controller wd(7) 
Controller ..sccrcrsrssccessssvsccnssaceosscssescscessacescencsaceessccsesesssussose 2d(7) 
CONETOLLET.....ssresesereesees zdformat(8) 
Controlling FMLI Object ......ssssessessesessssscssssssnseeaseneenee vsig(1F) 
controlling terminal .. fvhangup(2SEQ) 
controlling terminal (gentty) interface. w.tty(7) 


conv: toupper, tolower, _toupper, .. 
conversion program 
conversion tables... 
convert a termcap description into a.. 
convert and copy 8 file........s.sscscsssee: 
convert between 3-byte integers and. 
convert between long integer and... 
convert major/minor numbers... 
convert date and time to string... 
convert floating-point number to string... 
convert formatted input.....sssessese 
convert string to double-precision number. 


“13tol(3C) 
-2641(3C) 
_ttyname(3C) 
ctime(3C) 


lev. 


Permuted Index 


strtol, atol, atoi: 
password file scheme pwunconv: 
vsig: synchronize a 
UNIX-to-UNIX system. 
system file 

dd: convert and 
cpset: 

cpio: 

cp, ln, mv: 

volcopy: make literal 
transfer 

savecore: save a 


core: format of 

mem, kmem: 

and unset environment variables in 
cocreate, cosend, cocheck, 

checkeq: check documents for 
trigonometric functions trig: sin, 
codestroy: communicate to/ cocreate, 
sinh, 

we: word 

sum: print checksum and block 
m_next: increment global 

usclk: 32-bit microsecond 


cpio: format of 


and group IDs 

clock: report 

cpus_online: returns the number of 
CPUs on-line 


an existing one 
setcolor: redefine or 
gence: 

tmpnam, tempnam: 
creat: 

fork: 

ctags: 

tmpfile: 

pipe: 

admin: 

tasktbl: 

setsid: 

pathconv: search Interpreter 


cronlog: 
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strtol(3C) 
«pwunconv(1M) 
..vsig( 1F) 


convert string to integer 
converts from a two to a one.. 
co-process with the controlling 


copy... uucp(1C) 
copy. .uuto(1C) 
copy a file .--dd(1M) 
copy file and set mode, user, and group IDs pset(1) 


copy file archives in and out. -cpio(1) 


copy, link or move files... aC p(1) 
copy of filesystem......... ..volcopy(1M) 
copy: perform a standalone data...rssecsssssseesneesseee copy(8) 
core dump of the operating system. savecore(1M) 


core: format of core image file... ....core(4) 
core image file 
core memory.... 
core or in files..... 
coreceive, codestroy: communicate to 
COFTECE EQN BYNLAX.....csereeevsesnsere 
cos, tan, asin, acos, atan, atan2: 
cosend, cocheck, coreceive, 
cosh, tanh: hyperbolic functions... 


.coproc(1F) 
.checkeq(1) 


COUNL..ssseeeeees -we(1) 
count of a file. sum(1) 
counter.. .-m_next(3PPS) 
counter... .usclk(7) 


cp, In, mv: copy, link or move files. wc p(1) 
CPi0 ATCHIVE .....sessesseeseesessseeneeneeneene -cpio(4) 
cpio: copy file archives in and out -cpio(1) 
cpio: format of cpio archive «+. Cpio(4) 
cpp: C preprocessor... .see C and Lang Tools Binder 
cprs: compress object file........see C and Lang Tools Binder 
cpset: copy file and set mode, user, cpset(1) 
CPU time used..... clock(3C) 


.cpus_online(3PPS) 
.cpus_online(3PPS) 
..crash(1M) 


CPUs on-line... 
cpus_online: returns the number o 
crash: examine system images.... 
creat: create a new file or rewrite 
CTEALE A COLO ....cssesesesssseseseresesseseer 
create a front-end to the cc command. 
create a name for a temporary file 
create a new file or rewrite an existing one 
create a new process. 
create a tags file 
create a temporary file 
create an interprocess channel 
create and administer SCCS files 
create security table in shared memory. 
create session and set process group ID. 
criteria for filename 
cron: clock daemon... 
cron history file... 
cronlog: cron history file.. 


..gence(1M) 
.tmpnam(3S) 
..creat(2) 
.fork(2) 


pathconv(1F) 
acca cron(1M) 
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crontab: user 


cxref: generate C program 
pg: file perusal filter for 


functions 
hashing encryption 
with C-like syntax 


terminal 
cftime, ascftime, mktime, tzset:/ 


scr_dump: format of 
optimization package 

the user 

line of a file 

cut: 

cross-reference 
backup.codes: backup 
bdflush: update 

bdflush: update 

cron: clock 

strerr: STREAMS error logger 
crontabs: clock 
pwdhd: 
runacct: run 
300s: handle special functions of 
450: handle special functions of the 
zcat: compress and expand 

prof: display profile 

time a command; report process 
termcap: terminal capability 
diskusg: generate disk accounting 
t_revuderr: receive a unit 

sputl, sgetl: access long integer 
plock: lock process, text, or 

t_snd: send 

t_rev: receive 

t_snd: send data or expedited 
stat: 

brk, sbrk: change private 

shbrk, shsbrk: change shared 
brk, sbrk: change 

t_rev: receive data or expedited 
copy: perform a standalone 

types: primitive system 
t_revudata: receive a 

t_sndudata: send a 


creation 
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crontabs: clock daemon file. 
cross-reference .. 


crypt: encode/decode 
crypt: password and file encryption 
crypt, setkey, encrypt: generate.. 
csh: a shell (command interpreter). 
csplit: context Split.....ccssessseeseees 
ct: spawn getty to a remote terminal... 


ctags: create a tags file... .ctags(1) 
ctermid: generate filename for.. .ctermid(3S) 
ctime, localtime, gmtime, asctime,. ctime(3C) 


cu: call another UNIX system. 
curses screen image file......... 
curses: terminal screen handling and. 
cuserid: get character login name o: 
cut: cut out selected fields of each.... 
cut out selected fields of each line of a file 
exref: generate C program.....see C and Lang Tools Binder 


..cuserid(3S) 
.cut(1) 


cycle code definitions... backup_codes(4) 
daemon wu... oascecasterea bdflush(1M) 
daemon....... 


daemon to oversee password database. 
daily accounting .....csssecssees 
DASI 300 and 300s terminals 


data and system activity. timex(1) 
data base........... termcap(4) 
data by user ID.. diskusg(1M) 


data error indication 
data in a machine-independent/.. 
data in MEMOTY.......ecssssssseseserereees 
data or expedited data over a connection.. 
data or expedited data sent over a connection 
data over a connection. 
data returned by stat system call 
data segment size. 
data segment size.. 
data segment space allocation. 
data sent over a connection 
data transfer.. 


.t_snd(3N) 
t_rev(3N) 
.t_snd(3N) 


..t_rcvudata(3N) 


data unit.. .t_sndudata(3N) 
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Permuted Index 


diskinfo: disk device characteristic 
helpadm: change the Help Facility 
terminfo: terminal capability 

a terminal or query terminfo 
pwdhd: daemon to oversee password 
mkpwdbm: make a 

join: relational 

dbm_clearerr, dmb_blkflush: 
makewhatis: generate man page 
date: print and set the 

ascftime, mktime, tzset: convert 


/dbm_nextkey, dbm_error, 
dbm_delete/ dbm_open, 
dbm_close, dbm_fetch, dbm_store, 
/dbm_firstkey, dbm_nextkey, 
dbm_firstkey,/dbm_open, dbm_close, 
/dbm_fetch, dbm_store, dbm_delete, 
dbm_store, dbm_delete, dbm_firstkey, 
dbm_store, dbm_delete,/ 

dbm_open, dbm_close, dbm_fetch, 
pdbx, 


enable/disable patrol seeks on 
consistency check 


ctrace: C program 

pdbx, dbx: parallel 

try to contact remote system with 
crypt: encode/ 

timezone: set 

reset the current form field to its 
addusr.def: add user 

format disks or perform other 
gtty: set and get terminal state ( 
ut_add_user, ut_delete_user: add/ 
the delta commentary of an SCCS 
delta: make a 

cde: change the 

rmde]: remove a 

SCCS file 

comb: combine SCCS 

constructs 

whatis: 

close: close a file 

dup: duplicate an open file 

dup2: duplicate an open file 
setmntent: get file system 
getdtablemax: get maximum in-use 
getdtablesize: get 

setdtablesize: set 

de: 
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databaze..... 


database.... 

database creation... 
database for fast password lookup 
database operator.. 
database subroutines. 
databases.. 


date and time to string.... 
date: print and set the date.. 
dbm_clearerr, dmb_blkflush: databas 
dbm_close, dbm_fetch, dbm_store.,.... 
dbm_delete, dbm_firstkey/ 
dbm_error, dbm_clearerr,/ 
dbm_fetch, dbm_store, dbm_delete,.. 
dbm_firstkey, dbm_nextkey/.. 
dbm_nextkey, dbm_error/..... 
dbm_open, dbm_close, dbm_fetch, ... 
dbm_store, dbm_delete, dbm_firstkey, 
dbx: parallel debugger.. 


de: desk Calculator ...ecsssssssescssessorereseseressseestsensacssenenersenes de(1) 
DCC disks.... -sweepon(1M) 
dcheck: filesystem directory dcheck(1M) 
dd: convert and copy 8 file....sssssscsssesesssenerseeeseacenenen + dd(1M) 
debugger... see C and Lang Tools Binder 
debugger... see Cand me Tools Binder 


default system time zone 
default values... 
Aefaults .....crcsssseeeees sissesaee 
defect management functions 


delete users in utmp file 
delta... 
delta (change) to an SCCS file. 
delta commentary of an SCCS delta. 
delta from an SCCS file......sscseseees 
delta: make a delta (change) to an 


deroff: remove nroff, tbl, and eqn.. 
describe what a command i 
descriptor. 
descriptor. 
descriptor.. 
descriptor file entry.. 
descriptor table index 
descriptor table size... 
descriptor table size.. 
desk calculator 


“getmntent(3SEQ) 
..getdtablemax(2SEQ) 
getdtablesize(2SEQ) 
setdtablesize(2SEQ) 
de(1) 
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devbuild, devdestroy: build and 
destroy virtual devices 

virtua] devices devbuild, 
ioctl: control 

prtvtoc: print the VTOC of a block 
print the VTOC of a standalone disk 
sp: STREAMS pipe 

or the terminal associated with a 
the terminal/ ttydevname: get the 
’ diskinfo: disk 
devnm: 

clone: open any minor 

devtab: virtual 

dump kernel auto-configuration 
backup.dev: backup 

build and destroy virtual 

of virtual-to-physical mapping 

SA: 


constab: constructed 


convert between major/minor numbers/ 
blocks and inodes 

dmesg: collect system 

SCED: scsl/Ethernet/ 

terminal line connection 

bdiff: big 


comparison 
sdiff: side-by-side 


diff: differential file comparison. 


diff3: 3-way 


dir: format of 
unlink: link and unlink files and 
mkdir: make 
rm, rmdir: remove files or 
uucheck: check the uucp 
cd: change working 
chdir: change working 
chroot: change root 
get pathname of current working 
system level transition files 
ls: list contents of 
mkdir: make a 
mvdir: move a 
rmdir: remove a 
uucleanup: uucp spool 
dircmp: 
dcheck: filesystem 
system independent/ getdents: read 
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destroy virtual devices. i 

devbuild, devdestroy: build and... devbuild(1M) 
devdestroy: build and destroy... devbuild(1M) 
OVI CO cssnisisessccsnieacesssctsencned cacssssuscsoosesesenonsiustessecsxaviersrscs ioctl(2) 
device. prtvtoc(1M) 
device ..prtvtoc(8) 
I OVICE. secsasicscsssossesessresvad aivessesavassssscavseeseevsiessoinsesesssanaesasiied 8p(7) 
device... ttydevname(1) 


device associated with a terminal or.. ttydevname(1) 
device characteristic database. 
device name... 
device on a STREAMS driver... 
device table... 
device table..... dumpconft 1M) 
devices.. 
devices.. 
devices. 


devices table... 
devnm: device name. 
devtab: virtual device table... 
dev_to_ttyname, ttyname_to_dev:. 
df: report number of free disk... 
diagnostic messages to form error log 
Diagnostics board. 
dial: establish an out-going 


dift3: 3-way differential file 
difference program.........+6. 


differential file comparison. 
dir: format of directories... 
dircmp: directory comparison 


directory .... 
directory clean-up... 
directory comparison.. 
directory consistency check.. 


directory entries and put in a file. ...getdents(2) 
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Permuted Index 


dirent: file system independent 
unlink: remove 

chroot: change root 

pwd: working 

telldir, seekdir, rewinddir/ 
seekdir, rewinddir, closedir: 
mknod: make a 

directory entry 

basename, 


instructions 

t_unbind: 

enable, 

enable, disable: enable/ 

sweepon, sweepoff: enable/ 

acct: enable or 

swapping, or processor migration 
dis386: 

dis: object code 

t_revdis: retrieve information from 
t_snddis: send user-initiated 

installs a boot program on a 
diskusg: generate 

df: report number of free 

sd: SCSI 

wd: SSM SCSI 

zd: dual-channel 

disk formatter for dual-channel 
print the VTOC of a standalone 
diskinfo: 

CCSformat: standalone embedded SCSI 
controller zdformat: standalone 
getgeombyname: get 

quotactl: manipulate 

du: summarize 

quota: display 

database 

mkvtoc: populate VTOC on 
enable/disable patro] seeks on DCC 
mgmt functions format: format 
data by user ID 
indicator: 
quota: 

vi: screen-oriented (visual) 

man: 

virtual-to-physical mapping/ pmap: 
prof: 

bootflags: 

hypot: Euclidean 


anWor the working/ 


/dbm_error, dbm_clearerr, 
messages to form error log 
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dirent(4) 


directory entry....... ....unlink(2) 
directory for a command... .chroot( 1M) 
AirectOry NAMEC.....sssssscseeesessserenesesseeeesesecseeeeeorsnesneneensees pwd(1) 
directory: opendir, readdir, .directory(3X) 
directory operations.. .directory(3X) 
directory, or a special or ordinary file. mknod(2) 
dirent: file system independent......... .dirent(4) 
dirname: deliver portions of pathnames. ..basename(1) 
dis: code disassembler............ see C and Lang Tools Binder 
dis386: disassemble Series 386.. dis386(3SEQ) 
disable a transport endpoint....... .t_unbind(3N) 
disable: enable/disable LP printers... enable(1) 
disable LP printers........sssssssssesee ...enable(1) 
disable patrol seeks on DCC disks .sweepon(1M) 


disable process accounting... 


dis386(3SEQ) 
disassembler... .see C and Lang Tools Binder 
disconnect... nares 


disconnect request. 
isk csscssseasssesss sanestees 
disk accounting data by user ID 
disk blocks and inodes.. 
disk controller.... 

disk controller. 
disk controller 
disk controller 
disk device....... 
disk device characteristic database. 
disk formatter .....ssccccsesesserersssseeee 
disk formatter for dual-channel disk 


sesformat(8) 
...2dformat(8) 


disk geometry by name .getgeombyname(3SEQ) 
disk quotas.. .quotactl(2SEQ) 
disk usage... +e du(1M) 


disk usage and limits. 


diskinfo: disk device cha: ..diskinfo(4) 
disks.. mkvtoc(1M) 
disks.. .sweepon(1M) 


.format(1M) 
diskusg(1M) 
.indicator(1F) 


disks or perform other defect. 
diskusg: generate disk accounting 
display application specific alarms... 
display disk usage and limits 
display editor based on ex... 


display on-line man pages... . 

display or alter parameters o pmap(1M) 
display profile data........scscsssscsssseescssseeeanensenserserssses prof(1) 
display/change system boot flags. -bootflags(1M) 
distance function... ...-hypot(3M) 
ditsectbl: refresh security .dltsectbl(1M) 
dmb_blkflush: database subroutines... ..-ndbm(3X) 
dmesg: collect system diagnostic. .dmesg( 1M) 


DYNIX/ptx Reference Manual 


Permuted Index 


checkeq: check 

pretmp/ chargefee, ckpacct, 
strtod, atof: convert string to 
mrand48, jrand48, srand48, seed48,/ 
open any minor device on a STREAMS 
cmpt: compatibility partitioning 

cn: pseudoconsole 

terminal multiplexor 

streampty: STREAMS pseudo terminal 
vtoc: VTOC partitioning 

Xylogics 781 terminal multiplexor 
streamtty: Generic STREAMS tty 
consmem, sm, ss: console memory 


zd: 

/standalone disk formatter for 
dump: incremental filesystem 
dump: standalone memory 

od: octal 

of an object file 

format 

dumpfs: 

dump, dumpdates: incremental 


dumpconf: 
savecore: save a core 


device table 


auto-configuration device table 
dump, 


descriptor 
descriptor 
dup: 
dup2: 


echo: 


floating-point number to string 


end, etext, 

command 

casual users) 

edquota: 

sact: print current SCCS file 

ed, red: text 

ex: text 

sed: stream 

vi: screen-oriented (visual) display 
ld: link 

a.out: common assembler and link 
edit: text 
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documents for correct eqn syntax........ 
dodisk, lastlogin, monacct, nulladm,. 
double-precision number.. 
drand48, erand48, lrand48, 


dual-channel disk controller. 
dual-channel] disk controller. 


dump: dump parts... 
dump, dumpdates: incremental dump 
dump filesystem information 
dump format......secsssseseeseres 

dump: incremental filesystem dump.. 
dump kernel] auto-configuration. 
dump of the operating system..... 
dump: standalone memory dump. 
dumpconf: dump kernel ......s.ssseeseees 
dumpdates: incremental dump format. 
dumpfs: dump filesystem information... 
dup: duplicate an open file... 
dup2: duplicate an open file.. 
duplicate an open file descriptor 
duplicate an open file descriptor 
ec: forms compiler. 
echo arguments.... 
echo: echo arguments... 
echo: put string on virtual outpu 
ecvt, fevt, gevt: convert... 
ed, red: text editor...... 
edata: last locations in program. 
ede: run an externally described. 
edit: text editor (variant of ex for. 
edit user quotas... 
editing activity.. 
editor... 
edito 
editor.. 
editor based on ex... 
editor for object files 
editor output. 
editor (variant of ex for casual users)... 


resseza dump(8) 


Permuted Index 


effective user, real group, and 
/getgid, getegid: get real user, 


feplit: split [77, ratfor, or 

using full regular expressions 
CCSformat: standalone 

printers 

acct: 

enable, disable: 

sweepon, sweepoff: 

crypt: 

crypt, setkey, 

setkey, encrypt: generate hashing 
crypt: password and file 
makekey: generate 

program 

gence: create a front- 

/getgrgid, getgrnam, setgrent, 
setmntent: get file/ addmntent, 
bind an address to a transport 
t_close: close a transport 

at the current event on a transport 
t_open: establish a transport 
manage options for a transport 
t_unbind: disable a transport 
/getpwuid, getpwnam, setpwent, 
getspent, getspnam, setspent, 
/getutline, pututline, setutent, 
mailbug: submit a bug report or 
execution 

files 


environ: user 

putenv: change or add value to 
commands performed for multi-user 
profile: setting up an 

fpsetsticky: IEEE floating-point 

env: set 

getenv: return value for 

set, unset: set and unset 

deroff: remove nroff, tbl, and 
checkeq: check documents for correct 
jrand48, srand48, seed48/ drand48, 
complementary error function 
complementary error function _erf, 
error messages perror, 
error function and complementary 
error function erf, erfe: 
t_revuderr: receive a unit data 
system diagnostic messages to form 
errorlog: internal 
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edquota: edit user quotas... -edquota(1M) 
effective group IDs... 
effective user, real group, an 


efi: Extended Fortran Language. 


egrep: search a file for a pattern. 
embedded SCSI disk formatter.... 
enable, disable: enable/disable LP.. 


-cesformat(8) 
enable(1) 


enable or disable process accounting. ....acct(2) 
enable/disable LP printers......sssssssssssseeesees ...enable(1) 
enable/disable patrol seeks on DCC disks sweepon(1M) 
ONCOdC/ACCOdC....ssesessereseseesereeneerenseneneenes erypt(1) 
encrypt: generate hashing encryption.. crypt(3C) 
ENCTYPLION......sseeeseeee crypt(3C) 
encryption functions crypt(3X) 
encryption key. makekey(1) 
end, etext, edata: last locations in... .end(3C) 
end to the cc COMMANA.....cssssssereeereee «.gence(1M) 
endgrent, fgetgrent: get group file entry... .-getgrent(3C) 
endmntent, getmntent, hasmntopt, getmntent(8SEQ) 
endpoint... .t_bind(3N) 
endpoint t_close(3N) 
endpoint .t_look(3N) 
endpoint ..t_open(3N) 


endpoint t_optmgmt(3N) 
endpoint... t_unbind(3N) 
endpwent, fgetpwent: get password file/ getpwent(3C) 
endspent, fgetspent, Ickpwdf//.....+.« .getspent(3X) 


..getut(3C) 
-mailbug(1) 


endutent, utmpname, getutp’ 
enhancement request... 
env: set environment for comman 
.environ, .pref, .variables: FACE 
environ: user environment....... 
environment... 
environment 
environment... 

environment at login time.. 
environment control........ 
environment for command execution 
environment name 
environment variables in core or in files. 
eqn constructs 


“environ(6) 
.environ(5) 


“checkeq(1) 
.drand48(3C) 


erf, erfe: error function and 
erfc: error function and....... 
errno, sys_errlist, sys_nerr: system 
EYTOY FUNCtION.......scscseeeceeeseeesenseres 
error function and complementary. 
EFTOF iNGICALION........cccsssessesencseeees 
error log....... 


error log file. ...errorlog(4) 
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strclean: STREAMS 

strerr: STREAMS 

log: interface to STREAMS 

t_error: produce 

errormsg: 

errno, sys_errlist, sys_nerr: system 
introduction to system calls and 
matherr: 


spellin, hashcheck: find spelling 
/etc/shadow with information from / 
pwconv: installs and updates / 
end, 

SCED: scsl/ 

hypot: 

expr: 

test: condition 

t_look: look at the current 

to STREAMS error logging and 
sulog: log of substitute user 
(visual) display editor based on 
edit: text editor (variant of 


execlp, execvp: execute a file 
execlp, execvp: execute a/ exec: 
exec: execl, execv, 

exec: execl, execv, execle, execve, 
run: run an 

execle, execve, execlp, execvp: 
m_fork: 

construct argument list(s) and 

at, batch: 

regemp, regex: compile and 

uuxqt: 

env: set environment for command 
suspend and resume child process 
/system command 

sleep: suspend 

sleep: suspend 

monitor: prepare 

profil: 

execvp: execute a file exec: execl, 
exec: execl, execv, execle, 

execv, execle, execve, execlp, 


exit, 

exponential, logarithm, power/ 
uncompress, zcat: compress and 
pack, peat, unpack: compress and 
exp, log, log10, pow, sqrt: 
expression 
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strclean(1M) 
.strerr( 1M) 


error logger cleanup program 
error logger daemon.............0 
error logging and event tracing 
CYTOL MCSSAZE......eeseeeeee 
error message text file. 
error messages 
error numbers. 
error-handling function 
errorlog: internal error log file. 
errormsg: error message text file 


..errormsg(4) 

sates spell(1) 
«pweonv(1M) 
.pwconv(1M) 
..end(3C) 
..8ced(7) 
-hypot(3M) 
expr(1) 
-test(1) 
t_look(3N) 


etc/shadow with information from/. 
etext, edata: last locations in program.. 
Ethernet/Diagnostics board... 
Euclidean distance function.. 
evaluate arguments as an expression. 
evaluation commanzd........00. 
event on a transport endpoint... 
event tracing... ia 

events. 


OX cecavees vi(1) 
ex for casual users) edit(1) 
ex: text editor..... @X(1) 


exec: execl, execv, execle, execve, 
execl, execv, execle, execve,....... 
execle, execve, execlp, execvp: execute a file 
execlp, execvp: execute a file.. 
executable.... 
execute a file 
execute a subprogram in parallel. 
EXECULE COMMAND. .sesereresrsererseen 


»exec(2) 
..run(1F) 
«.exec(2) 
-m_fork(3PPS) 


execute commands at a later time ...ressssseserersssereercerare at(1) 
execute regular expression... regemp(3X) 
execute remote command requests.. uuxqt(1M) 
OXCCHU ON isiesscscciisccccesnsirnmcccnntcmnmnaT env(1) 
execution.... m_park_procs(3PPS) 
execution .uux(1C) 
execution for an interval.. -sleep(1) 
execution for interval! ..8leep(3C) 


execution profile. 
execution time profile... 
execv, execle, execve, execlp, . 
execve, execlp, execvp: execute a file .. 
execvp: execute a file. 
exit, _exit: terminate process. 
_exit: terminate process.. 
exp, log, log10, pow, sqrt: 
expand data... 
expand files... 
exponential, logarithm, power, square/.. 
expr: evaluate arguments as an 
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expr: evaluate arguments as an 
regex: compile and execute regular 
regcmp: regular 

regexp: regular 

for a pattern using full regular 

efi: 

ede: run an 

feplit: split 

floor, ceil, fmod, 

pathalias: alias file for 

environ, .pref, .variables: 

report inter-process communication 
a number 

factor: obtain the prime 

true, 

abort: generate an IOT 

stream 


number to string ecvt, 
- fopen, freopen, 
ferror, 
stream status inquiries 

for a filesystem 

felose, 

from a stream getc, getchar, 
/getgrnam, setgrent, endgrent, 
/getpwnam, setpwent, endpwent, 
gets, 

/getspnam, setspent, endspent, 
string 

cut: cut out selected 

mkfifo: make a 

access: determine accessibility of a 
chmod: change mode of 

chown: change owner and group of a 
core: format of core image 

cronlog: cron history 

crontab: user crontab 

crontabs: clock daemon 

ctags: create a tags 

selected fields of each line of a 

dd: convert and copy a 

make a delta (change) to an SCCS 
errorlog: internal error log 
errormsg: error message text 

* execve, execlp, execvp: execute a 
get: get a version of an SCCS 

group: group 

issue: issue identification 

header of a member of an archive 
ldaclose: close a common object 
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expression... 
expression... 


expression compile... regemp(1) 
expression compile and mai regexp(5) 
EXPTOSBIONS......ccccesseessseeeseecvee egrep(1) 
Extended Fortran Language .efl(1) 
externally described command... dc(1M) 


177, ratfor, or eff fileS..........scsccssesecereees 


alias(4) 
FACE files.. env(4) 
facilities status..........cssscessseeees -ipes(1) 
factor: obtain the prime factors of .factor(1) 
factors of a number........... 


factor(1) 
false: provide truth values is 
fault.... 
fclose, flush: close or flush a 
fentl: file control.........+0. 
fentl: file control options. 
fevt, gcvt: convert floating-point. 
fdopen: open & BtreaM....ccseseees 
feof, clearerr, fileno: stream status inquiries. 
ferror, feof, clearerr, fileno:........ 
ff: list filenames and statistics. 
flush: close or flush a stream... 
fgetc, getw: get character or word. 
fgetgrent: get group file entry.... 
fgetpwent: get password file entry 
fgets: get a string from a stream... 
fgetspent, Ickpwdf, ulckpwdf: get/. 
fgrep: search a file for a character 
fields of each line of a file ........s00000 
FIFO special file 


“getgrent(3 C) 
getpwent(3C) 
«ee gets(3S) 
~aetspent(O0 


file... access(2) 
file chmod(2) 
file. chown(2) 
file. core(4) 
file ronlog(4) 
file crontab(1) 
file 

file ctags(1) 
file ..cut(1) 
file dd(1M) 
file --delta(1) 
file ‘errorlog(4) 
file 

file exec(2) 


-ldahread(3X) 
Idclose(3X) 
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the file header of a common object _file.... -ldfhread(3X) 


of a section of a common object ..-.ldlseek(3X) 

file header of a common object Idohseek(3X) 

of a section of a common object .-ldrseek(3X) 
section header of a common object Idshread(3X) 
section of a common object ° ..ldsseek(3X) 

table entry of a common object hae dtbindex(3X) 
table entry of a common object ldtbread(3X) 

the symbol table of a common object i .ldtbseek(3X) 
number entries in a common object ..linenum(4) 
Minik: Link tovet file sieciecsccesssccavasssssecvevisatsnncttessoecesssansavesstesssas cnet osssuseseusayen link(2) 

mkfifo: make a FIFO special mk fifo(3C) 
mknod: build special mknod(1M) 

directory, or a special or ordinary ..mknod(2) 
format of a module configuration ..mod_config(4) 
motd; message-of-the-day file.......csssssssssssssesessosnsessssssensnsscessessansssansesavaranensesesensecee motd(4) 
newform: change the format of a text newform(1) 
null: the null ...null(7) 

passwd: password -passwd(4) 

files or subsequent lines of one -paste(1) 
product: installed products i -product(4) 

prs: print an SCCS e+e prs( 1) 

resfile: format of RCS resfile(4) 

read: read from ..read(2) 

readv: read vector from readv(2SEQ) 


reinit: run an initialization 7 5 reinit(1F) 
information for a common object buna taoesetane accustassedeateiatevauecksstaleclsvacasacecanstaapetsueveceaes’ reloc(4) 
rename: change the name of a 
rmdel: remove a delta from an SCCS 
compare two versions of an SCCS 
sccsfile: format of SCCS 

sccstorcs: build RCS file from SCCS 
section header for a common object 
format of curses screen image 
shadow: restricted password 


BCT. r_dump(4) 
.shadow(4) 


system shutdown information .shutdown(4) 
spellhist: unmatched spelling words : spellhist(4) 
print checksum and block count of & file .....ssssssssessssessssnsessnsessnseesscssoesesssnasesseeoescsaserenessnsessaenees sum(1) 
symlink: make symbolic link to a : symlink(2SEQ) 


format of a system configuration sys_config(4) 
tail: deliver the last part of a i 

term: format of compiled term a 

tmpfile: create a temporary ‘ mpfile(3S) 

create a name for a temporary a tmpnam(3S) 

access and modification times of a 

undo a previous get of an SCCS 

uniq: report repeated lines in a 

add/delete users in utmp 

the uucp directories and permissions 

val: validate SCCS 

write: write on a 

writev: write vector on a 


“utadduser(3X) 
uuucheck(1M) 
.-Val(1) 
.write(2) 
..writev(2SEQ) 
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utime: set 

ldfen: common object 
readfile, longline: reads 
cpset: copy 

Hewlett-Packard 2645A terminal tape 
tar: tape 

cpio: copy 

res: change RCS 

pwek, grpck: password/group 
mcs: manipulate the object 
diff: differential 

diff3: 3-way differential 
fentl: 

fentl: 

UNIX-to-UNIX system 
umask: set and get 

close: close a 

dup: duplicate an open 

dup2: duplicate an open 


sact: print current SCCS 

crypt: password and 

endgrent, fgetgrent: get group 

get file system descriptor 
endpwent, fgetpwent: get password 
ulckpwdf: get shadow password 
utmpname, getutpid: access utmp 
putpwent: write password 
putspent: write shadow password 
fgrep: search a 

grep: search a 

egrep: search a 

proto: prototype job 

pathalias: alias 

ldaopen: open a common object 
acct: per-process accounting 

ar: common archive 

manager, updates text files in ISIS 
intro: introduction to 

scestorcs: build RCS 

number entries of a common object 
filehdr: 

limits: 

unistd: 

ldfhread: read the 

ldohseek: seek to the optional 
split: split a 

mmap: map an open 
isismgr: ISIS 
merge: three-way 
ttyslot: find the slot in the utmp 
more: view a 


ISIS file format 
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file access and modification times.. 
file access routines 
file and gets longest line.. 

file and set mode, user, and group IDs 
file archiver.. 
file archiver.. 
file archives in and out. 
file attributes .. 
file checkers... 
file comment section... 
file comparison 


amet 


file descriptor.. 
file descriptor... 
file: determine file type 
file editing activity... 
file encryption functions.. 

..getgrent(3C) 
“getmntent(3SEQ) 
.getpwent(3C) 
manor 


file entry.. ._putspent(3X) 
file for a character string .fgrep(1) 
file for a pattern......... oie grep(1) 


file for a pattern using full regular expressions 


file for FACE 
file for reading. 
file format.... 


see C and Lang Tools Binder 
isismgr(1M) 
..intro(4) 
.secstores(1) 
.ldlread(3X) 
.filehdr(4) 


file from SCCS file.... 
file function... 
file header for common object 
file header for implementation-specific/.. 
file header for symbolic constants... 
file header of a common object file... 
file header of a common object file 


file into PieCes.......s.reccsseseescesseassnsrerseeneerensnsrensarescensnees split(1) 
file into the processs address space.. .-mmap(2SEQ) 
file manager, updates text files in isismgr(1M) 
file METYe.....seeccseeeerees -merge(1) 
file of the current user. ..ttyslot(3C) ~ 
file one full screen at a time... more(1) 
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fuser: identify processes using a 
creat: create a new 

Pg: 

lseek: move read/write 

fseek, rewind, ftell: reposition a 
bfs: big 

from a two to a one password 

stat, Istat, fetat: get 

identify processes using a file or 
symbol name for common object 
syms; common object 

newfs: construct a new 

/read directory entries and put in a 
/getmntent, hasmntopt, setmntent: get 
dirent: 

fa, inode: format of 

truncate, ftruncate: truncate a 
uusched: the scheduler for the uucp 
uucico: 

ftw: walk a 

file: determine 

umask: set 

object files 

mktemp: make a unique 

search Interpreter criteria for 
ctermid: generate 

ff: list 

ferror, feof, clearerr, 

search and print process accounting 
merge or add total accounting 
admin: create and administer SCCS 
cat: concatenate and print 

cmp: compare two 

or reject lines common to two sorted 
config: build system configuration 
ep, In, mv: copy, link or move 
.environ, .pref, .variables: FACE 

file header for common object 

find: find 

fspec: format specification in text 
fsplit: split [77, ratfor, or efi 

string, format of graphical 

ident: identify 

intro: introduction to special 

lockf: record locking on 

makedev: make system special 

peat, unpack: compress and expand 

pr: print 

and other information about RCS 

environment variables in core or in 

sort: sort and/or merge 

uucp: networking support 


DYNIX/ptx Reference Manual 


Permuted Index 


file or file structure 
file or rewrite an existing one.. 
file perusal filter for CRTs. 
file pointer ......ccssssesses 
file pointer in a stream... 


file symbol table entry. 


file BYBtEM ......scesescssseesseee 

file system independent format. 
file system descriptor file entry... af 
file system independent directory entry 
file system volume........... 


file to a specified length. ..truncate(2SEQ) 
file transport program... ..uusched(1M) 
file transport program for the uucp system........uucico(1M) 
file tree..... «-ftw(3C) 
FOC Y Pei ciciacssssccscesosesssacossusssacsessaccosessusuecscussevadesissenistiecnso file(1) 


file-creation mode mask umask(1) 


filehdr: file header for common .-filehdr(4) 
filename.. mktemp(3C) 
filename... pathconv(1F) 
filename for terminal. 


..ctermid(3S) 
filenames and statistics for a filesystem eee 
fileno: stream status inquiries. 


Permuted Index 


what: identify SCCS 

link, unlink: link and unlink 
init.d: system level transition 
ISIS file manager, updates text 
passmgmt: password 

rm, rmdir: remove 

paste: merge same lines of several 
ott: 

checkfays: check a 

list filenames and statistics for a 
mkfs; construct a 

mount: mount a 

repquota: summarize quotas for a 
tunefs: tune up an existing 
umount: unmount a 

volcopy: make literal copy of 
ckbupscd: check 
feck: 

dcheck: 

dump: incremental 
fetyp: determine 
dumpfs: dump 
statfs, fstatfs: get 
quotacheck: 
quotaon, quotaoff: turn 

restore: incremental 

ustat: get 

festat: report 

icheck: 

mnttab: mounted 

labelit: provide labels for 

mount, umount: mount and unmount 

umountal]: mount, unmount multiple 

checklist: list of 

fstab: 

greek: select terminal 

nl: line numbering 

pg: file perusal 

col: 

Ipfilter: administer 


interactive repair 


for an object library lorder: 
display/change system boot 
/fpgetsticky, fpsetsticky: IEEE 
isnan: isnand, isnanf: test for 

ecvt, fevt, gcvt: convert 

ldexp, modf: manipulate parts of 
ceiling, remainder, absolute value/ 
floor, ceil, fmod, fabs: 

felose, flush: close or 

a co-process with the controlling 
floor, ceil, 
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files in ISIS file format. 
files management... 
files or directories... 
files or subsequent lines of one/.. 
files that hold object architecture information 


filesystem... mount(2) 
filesystem. epquota(1M) 
filesystem... ..tunefs(1M) 
filesystem... -umount(2) 
filesystem... -volcopy(1M) 
filesystem backup schedule.. ..ckbupscd(1M) 
filesystem consistency Check and....sssscessesecseenceeese fsck(1M) 


filesystem directory consistency check... 
filesystem dump....... 
filesystem identifier. 
filesystem information 
filesystem information........csseccseers 
filesystem quota consistency checker 
filesystem quotas on and off. 


“‘dump{s( 1M) 

+e Statf{[s(2) 
..quotacheck(1M) 
quotaon(1M) 


filesystem restore... aia .«.restore(1M) 
filesystem statistics. 

filesystem status...... 

filesystem storage consistency check . 

filesystem table -mnttab(4) 
filesystems. abelit(1M) 
filesystems. ..mount(1M) 


-mountall(1M) 


filesystems. 
.checklist(4) 


filesystems processed by fsck and ncheck. 
file-system-table.. 


filter for CRTs 
filter reverse line-feeds... 
filters used with the LP print service.. 
find: find files 
find ordering relation. 


“cdl 1) 
..]pfilter(1M) 


.see C and Lang Tools Binder 
bootflags(1M) 
fpgetround(3C) 


floating-point environment control .. 
-isnan(3C) 


floating-point NaN (Not-A-Numbcr).. 
floating-point number to string 
floating-point numbers...... 
floor, ceil, fmod, fabs: floor,.... 
floor, ceiling, remainder, absolute va 
flush a stream. “felose(3S) 
FMLI object... vsig(1F) 
fmod, fabs: floor, ceiling, remainder, absolute/ .....floor(3M) 
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stream 
tegetpgrp: get 
tcsetpgrp: set 


system diagnostic messages to 

reset: reset the current 

acct: per-process accounting file 
dump, dumpdates: incremental dump 
put in a file system independent 
updates text files in ISIS file 
common object file symbol table 
management functions format: 
other defect management functions 
mod_config: 

sys_config: 

newform: change the 


fs, inode: 

gps: graphical primitive string, 
resfile: 

scesfile: 

fspec: 

strftime: 

intro: introduction to file 

utmp, wtmp: utmp and wtmp entry 
scanf, fecanf, sscanf: convert 

printf, fprintf, sprintf: print 
vprintf, vfprintf, vsprintf: print 
pwfix: remove incorrectly 
standalone embedded SCS] disk 
zdformat: standalone disk 

ASSIST menus or command 

ec: 

Ipforms: administer 

addformopt: add a 

ratfor: rational 

efi: Extended 

variables pathconf, 
fpgetround, fpsetround, 

fpsetmask, fpgetsticky/ 
/fpsetround, fpgetmask, fpsetmask, 


printf, 

fpgetround, fpsetround, fpgetmask, 
fpgetsticky,/ fpgetround, 
/fpgetmask, fpsetmask, fpgetsticky, 
pute, putchar, 

puts, 


getfrm: returns the current 
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fopen, freopen, fdopen: open a 
foreground process group ID. 
foreground process group ID 
fork: create a new process. 
form error 1Og......scsseessseeee 
form field to its default values 
format. 


format.. dump(4) 
format.. ..getdenta(2) 
format. isismgr(1M) 
format... ....8yms(4) 
format disks or perform other defect. .format(1M) 


format: format disks or perform... .format(1M) 
format of a module configuration file.. .mod_config(4) 
format of a system configuration file sys_config(4) 
format of a text file 


format of compiled term file 
format of core image file 
format of cpio archive... 
format of curses screen image file.. 
format of directories.....ssssseeee 
format of file system volume.. 
format of graphical files... 
format of RCS file..... 
format of SCCS file.. 
format specification in text files 
format time information... 
formats... 
formats... 
formatted input... 
formatted output........ 
formatted output of a varargs/. 
formatted password entries.. 
formatter... sansa beasaeaes 
formatter for dual-channel disk/ 


forms compiler.. 
forms used with the | LP print service 
form/SELECT window option to a menu.....addformopt(1M) 
Fortran dialect. 

Fortran Language 
fpathconf: get configurable pathname. 
fpgetmask, fpsetmask, fpgetsticky,/.. 
fpgetround, fpsetround, fpgetmask, 
fpgetsticky, fpsetsticky: IEEE/........ 
fprintf, sprintf: print formatted output 
fpsetmask, fpgetsticky, fpsetsticky/ 
fpsetround, fpgetmask, fpsetmask, . 
fpsetsticky: IEEE floating-point/... .fpgetround(3C) 
fputc, putw: put character or word on a stream.....putc(3S) 
fputs: put a string on a stream ...puts(3S) 
frame number .getfirm(1F) 


-pathcon{{2) 
.fpgetround(3C) 
.{pgetround(3C) 
.fpgetround(3C) 
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t_free: 

df: report number of 

malloc, 

mallinfo: fast main memory/ malloc, 
fopen, 

of floating-point numbers 
gence: create a 

volume 

scanf, 

list of filesystems processed by 
and interactive repair 

file pointer in a stream 
generation numbers 

files 

files 


stat, Istat, 

statfs, 

identifier 

fseek, rewind, 

communication package stdipe: 
specified length truncate, 


function and complementary error 
gamma: log gamma 

hypot: Euclidean distance 

entries of a common object file 
matherr: error-handling 

prof: profile within a 

erf, erfc: error 

50, j1, jn, yO, y1, yn: Bessel 

crypt: password and file encryption 
logarithm, power, square root 
ceiling, remainder, absolute value 
or perform other defect management 
sinh, cosh, tanh: hyperbolic 
sysi86: machine specific 

keys to internal menu system 
acos, atan, atan2: trigonometric 
math: math 

intro: introduction to 

300, 300s: handle special 

hp: handle special 

450: handle special 

file or file structure 

specified controlling terminal 
fread, 

accounting records 

gamma: log 


24 


fread, fwrite: binary input/output . 
free a library structure........ 
free disk blocks and inodes.. 
free, realloc, calloc: main memory allocato: 
free, realloc, calloc, mallopt.... 


-malloce(3C) 
-malloc(3X) 


freopen, fdopen: open a stream.... fopen(3S) 
frexp, ldexp, modf: manipulate parts. frexp(3C) 
front-end to the cc command... ..gencce(1M) 


fs, inode: format of file sySt@M........c.ccssssssssseeeessesesaesseeenee fs(4) 
fecanf, sscanf: convert formatted input scan{(3S) 
feck and ncheck......s.ssssesssssseseseeeseees checklist(4) 
feck: filesystem consistency check . .fsck(1M) 
fseek, rewind, ftell: reposition a. fseek(3S) 
fsirand: install random inode.. fsirand(1M) 
fapec: format specification in text... .fspec(4) 
feplit: split {77, ratfor, or efl... fsplit(1) 
fastat: report filesystem status stat(1M) 


fetab: file-system-table 
fetat: get file status 
fetatfs: get filesystem information. 
fstyp: determine filesystem............ 
ftell: reposition a file pointer in a stream 
ftok: standard interprocess.. 
ftruncate: truncate a file to a.. 
ftw: walk a file tree... 
function..... 


function.. gamma(3M) 
function. hypot(3M) 
function. Idlread(3X) 
function.. -matherr(3M) 


+n pToft5) 
eT (3M) 


function.. 
function and complementary error function... 
functions... 

functions. 
functions... 
functions... 
functions 
functions 
functions 
functions 
functions... 
functions and constants 
functions and libraries... 

functions of DASI 300 and 300s terminals.. 
functions of Hewlett-Packard terminals... 
functions of the DASI 450 terminal. 
fuser: identify processes using a 
fvhangup: virtually hangup the .. 


fwrite: binary input/output........ ...fread(3S) 
fwtmp, wtmpfix: manipulate connec! wtmp(1M) 
gamma function.............seseeeee amma(3M) 


gamma: log gamma function... 
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ecvt, fevt, 

command 

command forms astgen: program for 
fsirand: install random inode 

rand, srand: simple random-number 
streamtty: 

tty: controlling terminal 
getgeombyname: get disk 

character or word from a stream 

or word from a stream gete, 
working directory 

put ina file system independent/ 
descriptor table index 


size 

getuid, geteuid, getgid, 

name 

user, effective user, real/ getuid, 
number 


geometry by name 
getuid, geteuid, 
setgrent, endgrent, fgetgrent: get/ 


endgrent, fgetgrent: get/ getgrent, 
fgetgrent: get/ = getgrent, getgrgid, 
IDs 


currently marked menu items 


file system/ addmntent, endmntent, 


stream 

argument vector 

getopts, 

options 

process group, and parent/__ getpid, 


process, process group, and parent/ 
and parent process/ getpid, getpgrp, 
utilization information 


setpwent, endpwent, fgetpwent: get/ 
fgetpwent: get/ getpwent, getpwuid, 
endpwent, fgetpwent: get/ getpwent, 
stream 

readfile, longline: reads file and 
scsiinfo structure 


getscsiinfo, 
endspent, fgetspent, Ickpwdf/ 
fgetspent, Ickpwdf/ getspent, 


speed and terminal settings used by 
speed, and line discipline 
ct: spawn 
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gcvt: convert floating-point number to string.. 
gence: create a front-end to the CC... 
generating/modifying ASSIST menus or.. 
generation numbers.. 
generator 
Generic STREAMS tty driver interface.. 
(gentty) interface... 
geometry by name.. 
getc, getchar, fgetc, getw: get.. 
getchar, fgetc, getw: get character 


.astgen(1) 
fsirand(1M) 
rand(3C) 


getcwd: get pathname of current... getewd(3C) 
getdents: read directory entries and. sso Betdents(2) 
getdtablemax: get max in-u8e........000 getdtablemax(2SEQ) 
getdtablesize: get descriptor table......getdtablesize(2SEQ) 
getegid: get real user, effective user, real/.... .getuid(2) 
getenv: return value for environment... .getenv(3C) 
geteuid, getgid, getegid: get real... .getuid(2) 


getfrm: returns the current frame .getfrm(1F) 
getgeombyname: get disk/........000 getgeombyname(3SEQ) 
getgid, getegid: get real user, effective user/........getuid(2) 
getgrent, getgrgid, getgrnam,.... .. getgrent(3C) 
getgrgid, getgrnam, setgrent,.. ..getgrent(3C) 
getgrnam, setgrent, endgrent,.... ..getgrent(3C) 
getgroups: get supplementary group etgroups(2) 
getitems: returns a list of the .getitems(1F) 
getlogin: get login name scrseseeseeee Betlogin(3C) 
getmntent, hasmntopt, setmntent: get. 
getmsg: get next message off a 
getopt: get option letter from.. 
getopt: parse command option 
getoptcvt: parse command options 
getopts, getoptcvt: parse command 
getpagesize: get system page size. 
getpass: read a password......... 
getpgrp, getppid: get proceas,. 
getpid, getpgrp, getppid: get... 

getppid: get process, process group 
get_process_stats: get resource....get_process_ stats(2SEQ) 
getpseudotty: get pseudo terminals.....getpseudotty(3SEQ) 
getpw: get name from IUD......sesscsssesessesecereeeeees getpw(3C) 
getpwent, getpwuid, getpwnam,. .getpwent(3C) 
getpwnam, setpwent, endpwent, getpwent(3C) 
getpwuid, getpwnam, setpwent,.. getpwent(3C) 
gets, fgets: get a string from B......ssssecscsesesseerrenseesees gets(3S) 
gets longest line.......ssssseceeee readfile(1F) 
getscsiinfo, getscsimatch: get.. getscsiinfo(3SEQ) 
getscsimatch: get scsiinfo structure... getscsiinfo(3SEQ) 
getspent, getspnam, setspent...... ..getspent(3X) 
getspnam, setspent, endspent, ..getspent(3X) 
getty... gettydefs(4) 
getty: set terminal type, modes,.. 
getty to a remote terminal 


 getpagesize(2SEQ) 
getpass(3C) 
.getpid(2) 
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settings used by getty 

get real user, effective user, real/ 
microsecond clock 

pututline, setutent, endutent/ 
pututline, setutent/ getut: 
getut: getutent, 

getut: getutent, getutid, 

/setutent, endutent, utmpname, 
getc, getchar, fgetc, 

zdinfo structure 

getzdinfo, 

m_next: increment 

task: 

operating system terms and symbols 
mktime, tzset/ ctime, localtime, 
setjmp, longjmp: non-local 

format of graphical files 

primitive string, format of 

of graphical files gps: 
plot: 

plot: 


chown, chgrp: change owner or 
newgrp: log in to a new 

run command in its own process 
initgroups: initialize 

setgroups: set 

/get real user, effective user, real 
/getppid: get process, process 
group: 

pwek, grpck: password/ 

setgrent, endgrent, fgetgrent: get 


setpgrp: set process 

create session and set process 
tegetpgrp: get foreground process 
tcsetpgrp: set foreground process 
copy file and set mode, user, and 
getgroups: get supplementary 
user, real group, and effective 
setuid, setgid: set user and 

id: print user and 

groups: show 

chown: change owner and 

send a signal to a process or a 
maintain, update, and regenerate 


pwek, 
ssignal, 
stty, 


terminal fvhangup: virtually 
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gettydefs: speed and terminal . 
getuid, geteuid, getgid, getegid 
getusclk, usclk_init: get/init..... 
getut: getutent, getutid, getutline,. 
getutent, getutid, getutline,. 
getutid, getutline, pututline, setutent/.... 
getutline, pututline, setutent, endutent/. 


getutpid: access utmp file entry........000 getut(3C) 
getw: get character or word from a stream.. ..getc(3S) 
getzdinfo, getzdinfobyname: get.....csseceees getzdinfo(3SEQ) 
getzdinfobyname: get zdinfo structure......getzdinfo(3SEQ) 
Global COUNEEL ......seeesesssseseseseeteeneeteceees m_next(3PPS) 


w..task(4) 
.glossary(1) 
ctime(3C) 
.setjmp(3C) 


global security table 
glossary: definitions of common... 
gmtime, asctime, cftime, ascftime,. 
goto.. 


gps: graphical primitive string, gps(4) 
graphical files.......sscesesessereseee gps(4) 
graphical primitive string, format. gps(4) 
graphics interlace .....s.sesssecseeeeereee plot(4) 


..plot(3X) 
..greek(1) 


graphics interface subroutines. 
greek: select terminal filter...... 
grep: search a file for a pattern 


group. 


group. ..newgrp(1M) 
QTOUP .sesesssssccecscsecssncsrsssnonsssasaencsnsnsssosesacsscansevanceserens setpgrp(1) 
group access list... initgroups(3SEQ) 
group access list... .setgroups(2SEQ) 
group, and effective group IDs. we getuid(2) 


group, and parent process IDs. we getpid(2) 


BrOup file......eseseesee 

group file checkers. ..pwek(1M) 
group file entry .......s00 .getgrent(3C) 
group: group file «group(4) 
group ID... ..Setpgrp(2) 
QTOUP ID ...sccsscsescssssssssnesssssncsnsssceneencarersscnnsavesncssusonssses setsid(2) 
group ID .tegetpgrp(2) 
group ID tcesetpgrp(2) 


QTOUP IDB..cscccssssessssssssssnsssusncscorsssnesencnsensanseanensocerseenseres cpset(1) 
group IDs. ..getgroups(2) 
group IDs. ...getuid(2) 
group IDs. .setuid(2) 
group IDs and names -id(1M) 
group memberships .. groups(1) 
group of a file......... .chown(2) 
group of processes. «kill(2) 
groups of programs... .-»make(1) 
groups: show group memberships.. ....groups(1) 
grpck: password/group file checkers... .-pwek(1M) 
gsignal: software signals..........:.s:+« ssignal(3C) 
gtty: set and get terminal state (defunct). stty(2) 
hangup the specified controlling.........s+ fvhangup(2SEQ) 
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nohup: run a command immune to 
hsearch, hcreate, hdestroy: manage 
spell, hashmake, spellin, 

erypt, setkey, encrypt: generate 
spelling errors spell, 
addmntent, endmntent, getmntent, 
search tables hsearch, 
hsearch, hcreate, 

scnhdr: section 

filehdr: file 

limits: file 

unistd: file 

ldfhread: read the file 

ldohseek: seek to the optional file 
/read an indexednamed section 
Idahread: read the archive 

helplog: monitor 

help: operating system 

helpadm: change the 


database 


file archiver hpio: 
hp: handle special functions of 
cronlog: cron 

ott: files that 

uptime: show 

Hewlett-Packard terminals 

tape file archiver 

hash search tables 

sinh, cosh, tanh: 


u3b5, vax: get processor/ machid: 
consistency check 


m_get_myid: return process 

issue: issue 

fstyp: determine filesystem 

shmget: get shared memory segment 
file and set mode, user, and group 
getgroups: get supplementary group 
process group, and parent process 
real group, and effective group 
setuid, setgid: set user and group 

id: print user and group 

/fpsetmask, fpgetsticky, fpsetsticky: 
core: format of core 

scr_dump: format of curses screen 
crash: examine system 

limits: file header for 

pwfix: remove 

m_next: 
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hangups and quits.... nohup(1) 
hash search tables... -hsearch(3C) 
hhashcheck: find spelling er Tors ......s.sssscssscssesesesesseesee spell(1) 
hashing encryption ......sssssscsee 
hashmake, spellin, hashcheck: find 
hasmntopt, setmntent: get file/. 
hcreate, hdestroy: manage hash.. 
hdestroy: manage hash search tables 
header for a common object file... 
header for common object files... 
header for implementation-specific constants. 
header for symbolic constants.. 
header of a common object file. 
header of a common object file. 
header of a common object file.. 
header of a member of an archive file 
help actions.... 
Help Facility.. 
Help Facility database 
help: operating system Help Facility.. 
helpadm: change the Help Facility. 
helplog: monitor help actions........... 
Hewlett-Packard 2645A terminal tape . 
Hewlett-Packard terminals... 


..getmntent(3SEQ) 
-hsearch(3C) 
-hsearch(3C) 


..helpadm(1M) 
hel p(1) 
.-helpadm(1M) 


hold object architecture information......sssssseeeerseeees ott(4) 
how long system has been up.... 
hp: handle special functions of. 
hpio: Hewlett-Packard 2645A termina 
hsearch, hcreate, hdestroy: manage 
hyperbolic functions ........s0sessees 
hypot: Euclidean distance function 
i386, ns32000, pdp11, u3b, u3b2, 
icheck: filesystem storage.. 
ident: identify files 
identification.. 
identification fi 
identifier. 
identifier... 


“hsearch(3C) 
..sinh(3M) 
hypot(3M) 
....machid(1) 


IDs and DG INGS isssiccacsssessonanasssnusnss waa 
IEEE floating-point environment/ pgetround(3C) 
Rimage file ..ccsaiscscsacscancecsesvsossssecsocsecensacscssosarasseanessisi toesnes core(4) 
image file 
images. 
implementation-specific constants .. 
incorrectly formatted password entries. 
increment global counter. 
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dump, dumpdates: 
dump: 
restore: 


get maximum in-use descriptor table i 


common/ ldtbindex: compute the 
common object/ _Idtbread: read an 
commonldshread, Idnshread: read an 
ldsseek, ldnsseek: seek to an 

receipt of an orderly release 

receive a unit data error 

specific alarms and/or the working 
specific alarms and/or the working/ 
calculate number of blocks and 
syscall: 

terminfo descriptions 

getusclk, usclk_init: get/ 

inittab: script for the 

initialization 

files directory 

list 

init, telinit: process control 

reinit: run an 

bcheckre: system 

tput: 

s_init_barrier, s_wait_barrier: 
initgroups: 

/s_lock, s_clock, s_unlock: 

setup: 


clri: clear 

fs, 

feirand: install random 
number of free disk blocks and 


fecanf, sscanf: convert formatted i 


ungetc: push character back into 


fread, fwrite: binary i 


poll: STREAMS 

stdio: standard buffered 
uustat: uucp status 
install: 


fsirand: 
onthe BOM _ bomverify: perform an 
on a disk 


product: 

installboot: 

with information from/ pweonv: 
dis386: disassemble Series 386 
mailx: 


filesystem consistency check and 
console: console 
Ip: Systech parallel line printer 
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incremental dump format... 
incremental filesystem dump... 
incremental filesystem restore 


é getdtablemax(2SEQ) 
ldtbindex(3X) 
.ldtbread(3X) 
.ldshread(3X) 


index of a symbol table entry of a.. 
indexed symbol table entry of a. 
indexednamed section header of a 
indexednamed section of a common/ 


indication... ..t_revrel(3N) 
indication. .t_revuderr(3N) 
indicator... -indicator(1F) 


.indicator(1F) 
-nblocks(3SEQ) 
... syscall(2) 
-infocmp(1M) 


indicator: display application.. 
indirect blocks........ 
indirect system call 
infocmp: compare or prin’ 
init microsecond clock 
init PFOCCBS.......eeeceee 
init, telinit: process control. eal 

avsspeieiaal .init.d(4) 


init.d: system level transition 
initgroups: initialize group access.. initgroups(3SEQ) 
initialization....... «init(1M) 


initialization file. 
initialization procedures... 
initialize a terminal or query terminfo atabase sases tput(1) 
initialize barrier, wait at barricr......s_wait_barrier(3PPS) 
initialize group access list....... initgroups(3SEQ) 
initialize, lock, unlock locks.. “8. ee 
initialize system for first user.. 
inittab: script for the init proces: 
NOE is ssoisevessesceccsssncasvssuidsoasacsessdsei 


inode: format of file system VOIUMC....ssssssessseesecseeesersees fs(4) 
inode generation numbers... fsirand(1M) 
inodes. Gd f(1M) 
input... scan{(3S) 
input stream ungetc(3S) 
input/output.....erererececeesenes fread(3S) 
input/output multiplexing, -poll(2) 
input/output package... stdio(3S) 
inquiry and job control. -uustat(1C) 
install commands.... install(1M) 
install: install commands.. install(1M) 


install random inode generation numbers.. 
installation consistency check based... 
installboot: installs a boot program.. 
installed products file. 
installs a boot program on a dis 
installs and updates /etc/shadow 
instructions... 
interactive message processing system. 
interactive repair 
interface... 

interface 


“bomverify( 1M) 
installboot(1M) 

sased product(4) 
installboot(1M) 
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© mtio: UNIX magnetic tape 


plot: graphics 


Generic STREAMS tty driver i 


swap: swap administrative 

termio: general terminal 

tg: SCSI 1/2-inch magnetic tape 

tty: controlling terminal (gentty) 

wp: SSM parallel line printer 
Xylogics 472 MULITBUS magnetic tape 
timod: Transport 

STREAMS module _tirdwr: Transport 
Transport Interface read/write 

plot: graphics 

sysadm: menu 


and event tracing log: 
errorlog: 

syskeymap: identify keys to 

asa: 


pathconv: search 

csh: a shell (command 
pipe: create an 

ipes: report 

stdipe: ftok: standard 
tfipe: 


ncheck: generate pathnames from 
@ streamio: STREAMS 


abort: generate an 

semaphore set, or shared memory ID 
communication facilities status 
/isxdigit, islower, isupper, isalpha, 
isdigit, isxdigit, islower, isupper, 
Aiscntrl, ispunct, isprint, isgraph, 
ttyname, 

/isupper, isalpha, isalnum, isspace, 
isalpha, isalnum, isspace, iscntrl/ 
/isspace, iscntrl, ispunct, isprint, 

file manager, updates text files in 
files in ISIS file format isismgr: 
text files in ISIS file format 

isdigit, iaxdigit, 

floating-point NaN (Not-A-Number) 
isnan: 

(Not-A-Number) isnan: isnand, 
/isalnum, isspace, iscntrl, ispunct, 
/isalpha, isaloum, isspace, iscntrl, 
Aslower, isupper, isalpha, isaloum, 


isdigit, iaxdigit, islower, 
isalnum, isspace, isentrl/ isdigit, 


getpw: get name from 
bessel: 
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-mtio(7) 


plot(4) 
interface. streamtty(7) 
interface 5 
interface 
interface 
interface. 


interface... 
Interface cooperating STREAMS module 
Interface read/write interface 
interface STREAMS module.. 
interface subroutines... 
interface to do system administration. 
interface to STREAMS error logging.. 
internal error log file 
internal menu system fUNCtIONS.......esseeeneee syskeymap(4) 
interpret ASA carriage control characters 
Interpreter criteria for filename.. 
interpreter) with C-like syntax 
interprocess channel ........ss000 
inter-process communication facilities status.. 
interprocess communication package........ eocceses Ji 
interprocess communication reporter 
i-numbers........ 
ioctl commands 
ioct]: control device 
IOT fault....cesecssoeeee : 
iperm: remove a message queue,. 


..ncheck(1M) 
..8treamio(7) 
ioctl(2) 
.-abort(3C) 


ipes: report inter-process......ss00 ..-ipes(1) 
isalnum, isspace, iscntrl, ispunct,.. ..ctype(3C) 
isalpha, isalnum, isspace, iscntrl,/ ..ctype(3C) 
isascii, tolower, toupper, toascci//. sf 


isatty: find name of a terminal... 
iscntrl, ispunct, isprint, isgraph/. 
isdigit, isxdigit, islower, isupper,.. 
isgraph, isascii, tolower, toupper/... 
ISIS file format 
ISIS file manager, updates text.. 
isismgr: ISIS file manager, updates. 
islower, isupper, isalpha, isalnum, isspace/. 
isnan: isnand, isnanf: test fOr.........seseeee: 
isnand, isnanf: test for floating-point Nal/.. 
isnanf: test for floating-point NaN... 
isprint, isgraph, isascii, tolower/.. 
ispunct, isprint, isgraph, isascii/. 
isspace, isentrl, ispunct, isprint/... 
issue identification file 
isupper, isalpha, isalnum, isspace/ 
isxdigit, islower, isupper, isalpha, 
IUD... 


ae 1M) 
isismgr(1M) 


.getpw(3C) 


y0, yl, yn: Bessel functions... bessel(3M) 
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bessel: j0, 

bessel: jO, jl, 

uustat: uucp status inquiry and 
proto: prototype 


/erand48, lrand48, nrand48, mrand48, 
sigsetjmp, siglongjmp: non-local 
dumpconf: dump 

makekey: generate encryption 
syskeymap: identify 

apropos: locate commands by 

system command locate: use 
killall: 

m_kill_procs: 


a group of processes 


mem, 

kMBmem, 

ksh, rksh: 
standard/restricted command and/ 
integers and long integers 

and base-64 ASCII string a64l, 
filesystems 

labelit: provide 

awk: pattern scanning and processing 
be: arbitrary-precision arithmetic 
efi: Extended Fortran 

command and programming 

pattern scanning and processing 
command programming 

cftime: 

chargefee, ckpacct, dodisk, 
/setspent, endspent, fgetspent, 
/mrand48, jrand48, srand48, seed48, 
, files 


Idclose, 

a member of an archive file 

for reading Idopen, 
object file 
frexp, 
routines 
common object file 

common object file symbol table/ 
number entries of a common/Idlread, 
entries of a/ ldlread, ldlinit, 
manipulate line number entries of a/ 
number entries of a section of a/ 
entries of a section of a/ ldlseek, 
ofasectionofacommon/ ldrseek, 


floating-point numbers 
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bessel(3M) 
sae jean 


jl, jn, yO, yl, yn: Bessel functions. 
jn, y0, yl, yn: Bessel functions... 
job control... 
job file for at. 
join: relational database operator.. 
jrand48, srand48, seed48, lcong48/.. 
jumps.. 


sie join(1) 
..drand48(3C) 
sigsetjmp(3C) 
..dumpconf( 1M) 
..makekey(1) 
syskeymap(4) 


keys to internal menu system functions. 


keyword lookup.. ..apropos(1) 
keywords to identify an operating.. -locate(1) 
kill all active processes -killall(1M) 
kill child processes........ m_kill_procs(3PPS) 


kill: send a signal to a process or.. 
kill: terminate a process 
killall: kill all active processes. 
kMBmem, kMWmem: MULITBUS memory. 
kmem: Core MEMOTY .......sseeseeseee ...mem(7) 
kMWmem: MULITBUS memory... ..._kmmem(7) 
KornShell, a standard/restricted command and /...... 

ksh, rksh: KornShell, a 
13tol, ltol3: convert between 3-byte 
164a: convert between long integer 


-killall(1M) 
-kmmem(7) 


‘13tol(3C) 
-2641(3C) 


labelit: provide labels for. abelit(1M) 
labels for filesystems. Jabelit(1M) 
language... awk(1) 
language be(1) 
Language efl(1) 
language »ksh(1) 
language .nawk(1) 


.8h(1) 
.cftime(4) 
.acctsh(1M) 


language... 
language specific strings.......0... or 
lastlogin, monacct, nulladm, pretmp/.. 
Ickpwdf, ulckpwdf: get shadow/. .getspent(3X) 
lcong48: generate uniformlly/...... -drand48(3C) 
ld: link editor for object.........see C and Lang Tools Binder 
1d0: STREAMS tty line discipline 
ldaclose: close a common object fil 
ldahread: read the archive header of 
Idaopen: open a common object file .. 
ldclose, Idaclose: close a common... 
ldexp, modf: manipulate parts o 
ldfcen: common object file access.. 
ldfhread: read the file header of a.. 
ldgetname: retrieve symbol name fo’ 
Idlinit, Idlitem: manipulate line... 
Idlitem: manipulate line numbe 
ldlread, Idlinit, ldlitem: 
ldlseek, Idnlseek: seek to line. 
ldniseek: seek to line number.. 
ldnrseek: seek to relocation entries... 


.Idelose(3X) 


.ldahread(3X) 
-ldopen(3X) 
-ldclose(3X) 
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section header of a/ ldshread, 
section of a common object/ Idsseek, 
header of a common object file 
object file for reading 

relocation entries of a section of/ 
indexednamed section header of a/ 
indexednamed section of a common/ 
symbol table entry of a common/ 
table entry of a common object file 
of a common object file 

truncate a file to a specified 

init.d: system 

lexical tasks 

lex: generate programs for simple 
search, 

intro: introduction to functions and 
find ordering relation for an object 
introduction to Parallel Programming 
t_sync: synchronize transport 
t_alloc: allocate a 

t_free: free a 

shell (command interpreter) with C- 
quota: display disk usage and 
ulimit: get and set user 
implementation-specific constants 
returns the number of CPUs on- 
line: read one 

puts its arguments on message 

all but one active processor off 
reads file and gets longest 

establish an out-going terminal 

set terminal type, modes, speed, and 
1d0: STREAMS tty 

set terminal type, modes, speed, and 
man: display on- 

linenum: 

Adlinit, ldlitem: manipulate 
acommon/ ldlseek, ldnlseek: seek to 
nl: 

cut: cut out selected fields of each 
Ip: Systech parallel 

wp: SSM parallel 


lsearch, Ifind: 

col: filter reverse 

common object file 

readlink: read value of a symbolic 
link, unlink: 

ld: 

a.out: common assembler and 


cp, In, mv: copy, 
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Idnshread: read an indexednamed 


ldnsseek: seek to an indexednamed ..ldsseek(3X) 
Idohseek: seek to the optional file.. Idohseek(3X) 
Idopen, ]daopen: open a common Idopen(3X) 
Idrseek, ldnrseek: seek to...... drseek(3X) 


ldshread, Idnshread: read an 
ldsseek, ldnsseek: seek to an........ 
ldtbindex: compute the index of a 
ldtbread: read an indexed symbol... 
Idtbseek: seek to the symbol table... 
length. 
level transition files directo 


"-truncate(2SEQ) 
-init.d(4) 
wll 


lex: generate programs for simple... ex(1) 
lexical tasks ........ssscssssssssssceseees lex(1) 
lfind: linear search and update 

libraries.. 

library. .see C and Lang Tools Binder 
Library .-intro(3PPS) 


library.. 
library structu: 
library structure... 
like syntax. 
limits... 


.t_free(3N) 
.+8h(1) 
quota(1) 


limits... ulimit(2) 
limits: file header for.. .-limits(4) 
line... .cpus_online(3PPS) 
line... .line(1) 
line... message(1F) 
line offline_all(3SEQ) 


line... ..readfile(1F) 
line connection... 
line discipline... 
line discipline 
line discipline 
Tine :man Pages .cssesesssccsssdavesenssssctacaicnsaresesssitesscsacsarseaiee 
line number entries in a common object file 
line number entries of a common object/... 
line number entries of a section of.. 
line numbering filte’ 
line of a file. 
line printer interface, 
line printer interface 
line: read one line... 
linear search and update “Isearch(3C) 
TS aia ssccconsinssasinesesmissionesisnnienvsennnssennsvivemrsssesesnavaead col(1) 
linenum: line number entries in 


..readlink(2SEQ) 
«.slink(1M) 
ng Tools Binder 


link and unlink files and directories.. 
link editor for object files 


link or move files... 
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link: 
symlink: make symbolic 
and directories 


initgroups: initialize group access 
nlist: get entries from name 
setgroups: set group access 
varargs: handle variable argument 
output of a varargs argument 

ls: 

ff: 

checklist: 
getitems: returns a 
t_listen: 

listing 

xargs: construct argument 
volcopy: make 

cp, 
ctime, 
apropos: 
operating system command 
setlocale: set programs 

end, etext, edata: last 
plock: 

m_lock, m_unlock: 

s_clock, s_unlock: initialize, 


feck and ncheck 


ascftime, mktime, tzset:/ 


lockf: record 

m_lock, m_unlock: lock, unlock 
s_unlock: initialize, lock, unlock 
diagnostic messages to form error 
errorlog: internal error 

gamma: 

newgrp: 

logging and event tracing 

logarithm, power, square root/ exp, 
about RCS files rlog: print 
Aasr/adm/loginlog: 

sulog: 

logarithm, power, square/ exp, log, 
log, log10, pow, sqrt: exponential, 
strclean: STREAMS error 

strerr: STREAMS error 

log: interface to STREAMS error 
/usr/adm/loginlog: log of failed 
getlogin: get 

logname: get 

cuserid: get character 

logname: return 

passwd: change 

tfmenush: assign menu system as user 
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....initgroups(3SEQ) 
sasisacioad nlist(3C) 
.setgroups(2SEQ) 

sasaie varargs(5) 
es — 
list contents of directory ... 
list filenames and statistics for a 
list of filesystems processed by 
list of the currently marked menu items 
listen for a connect request... 
list: produce C source 
list(s) and execute comman 
literal copy of filesystem....... 


.getitems(1F) 
.t_listen(3N) 
ng Tools Binder 


In, mv: copy, link or MOVE fileS ....s.seccsssseesessesseeenerereneeaen ep(1) 
localtime, gmtime, asctime, cftime, . ctime(3C) 
locate commands by keyword lookup ..apropos(1) 
locate: use keywords to identify an ..cccsseseressssees locate(1) 
Location....sccssssessessees .setlocale(3C) 
locations in program... end(3C) 
lock process, text, or data in memo: plock(2) 


lock, unlock locks... 
lock, unlock locks.... 
lockf: record locking on files 
locking on files... 


.8_lock(3PPS) 
lock {3C) 
ite -lock{(3C) 
m_lock(3PPS) 
_lock(3PPS) 


log gamma function... 
log in to a new group.. 
log: interface to STREAMS error.. 
log, log10, pow, sqrt: exponential,. 
log messages and other information. 
log of failed login attempts...... 
log of substitute user events 
1og10, pow, sqrt: exponential, 
logarithm, power, square root/.. 
logger cleanup program.... 


“Toginlog(4) 
..sulog(4) 
xp(3M) 
.exp(3M) 
..strelean(1M) 


logger daemon...........00« ..8trerr(1M) 
logging and event tracing.....-s.scsssssssecresseenesaeserencsenees log(7) 
login attempts . loginlog(4) 
login name... etlogin(3C) 
login name... -logname(1) 
login name of the user... .cuserid(3S) 
login name of user .-logname(3X) 
login password and password attributes ..passwd(1) 
login shell........ tfmenush(1M) 
login: sign on... login(1) 
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® setting up an environment at 


/usr/adm/ 


setjmp, 

readfile, 

apropos: locate commands by keyword 
make a database for fast password 
relation for an object library 

the LP print service 

cancel: send/cancel requests to the 
Ipadmin: configure the 

administer filters used with the 
administer forms used with the 
information about the status of the 
Apshut, lpmove: start/stop the 
enable, disable: enable/disable 
accept, reject: allow or prevent 
interface 

service 

with the LP print service 

the LP print service 

processing module 

service and move/ _lpsched, Ipshut, 
the LP print service and move/ 
© print service and move/ Ipsched, 
status of the LP print service 
supported by the menu system 
priorities 

srand48, seed48,/ drand48, erand48, 


update 


stat, 
integers and long integers 13tol, 


u3b2, u3b5, vax: get processor type/ 
show the configuration of the 
sysi86: 

values: 

sget]: access long integer data ina 
m4: 

mtio: UNIX 

tg: SCSI 1/2-inch 

xt: Xylogics 472 MULITBUS 

mt: 

rmail: send mail to users or read 
read mail 

mail, rmail: send 

enhancement request 

processing system 

groups of programs make: 
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loginlog: log of failed login attempts. 
logname: get login name......... acaaeeas 
logname: return login name of user 
longjmp: non-local goto......... pavsesinne 
longline: reads file and gets longest line 
lookup... 
lookup... 
lorder: find ordering. 
Ip, cancel: send/cancel requests to.. «lp(1) 
LP print service...... 
LP print service .. 
LP print service. 
LP print service.. 
LP print service... 
LP print service and move requests. Ipsched(1M) 
LP printers... .enable(1) 
LP requests. 
Ip: Systech parallel line printer.... 
lpadmin: configure the LP print. 
Ipfilter: administer filters used.... 
lpforms: administer forms used with.. 
lpmod: parallel printer canonical. 
lpmove: start/stop the LP print.... 
lpsched, Ipshut, Ipmove: start/stop... 
Ipshut, Ipmove: start/stop the LP. 
Ipstat: print information about the... 
Iptypes: table of printer types 
Ipusers: set printing queue..... 
lrand48, nrand48, mrand48, jrand48,. 
Is: list contents of directOry....sessssssesserseerscenrecneonrernsenees 18(1) 
lsearch, lfind: linear search ani 
lseek: move read/write file pointer.. 


..lpadmin(1M) 


.Ipfilter(1M) 


Istat, fetat: get file status....... .-8tat(2) 
Itol3: convert between 3-byte. -13tol(3C) 
14: MACTO PYOCEBEOF .eesseecessseereeesees -m4(1) 
machid: i386, ns32000, pdp11, u3b,. machid(1) 
MACHINE issnsssersoceasssncssecasceteiens showcefg(1M) 


.sy8i86(2) 
.values(5) 
eos 


machine specific functions. 
machine-dependent values.. 
machine-independent fashion. 
MACTO PYOCBBOF......c0essee0e 
magnetic tape interface .. 
magnetic tape interface. 
magnetic tape interface... 
magnetic tape manipulating program. 


mail, rmail: send mail to users or.. 
mail to users or read mail.......... 
mailbug: submit a bug report or 
mailx: interactive message........ 
maintain, update, and regenerate. 


Permuted Index 


programs intro: introduction to 
/ttyname_to_dev: convert between 
regenerate groups of programs 

man page databases 


databases makealiases, 
/free, realloc, calloc, mallopt, 
memory allocator 

mallopt, mallinfo: fast main memory/ 
malloc, free, realloc, calloc, 


makealiases, makewhatis: generate 
man: display on-line 

tsearch, tfind, tdelete, twalk: 
hsearch, hcreate, hdestroy: 
t_optmgmt: 

passmgmt: password files 
sigignore, sigpause: signal 
format disks or perform other defect 


endpoint 


file format isismgr: ISIS file 
mt: magnetic tape 

parameters of virtual-to-physical 
m_single, m_multi: 


umask: set file-creation mode 
umask: set and get file creation 
regex: 

regular expression compile and 
math: 


comment section 


read the archive header of a 

groups: show group 

memset: memory operationamemory: 
memory operationnemory: memccpy, 
operatiomemory: memccpy, memchr, 
memory: memccpy, memchr, memcmp, 
kMBmem, kMWmem: MULITBUS 
mem, kmem: core 

lock process, text, or data in 

create security table in shared 
malloc, free, realloc, calloc: main 
calloc, mallopt, mallinfo: fast main 
shmalloc, shrealloc, shfree: shared 
valloc: aligned 

shmctl: shared 

consmem, 8m, 88: console 

dump: standalone 

spawn new process in a virtual 
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maintenance commands and application.. ..intro(1) 
major/minor numbers/tty names. .dev_to_ttyname(3C) 
make: maintain, update, and. 
makealiases, makewhatis: generate... 
makedev: make system special files 
makekey: generate encryption key. 
makewhatis: generate man page.... 
mallinfo: fast main memory allocator. 
malloc, free, realloc, calloc: main 
malloc, free, realloc, calloc, .......... 
mallopt, mallinfo: fast main memory/ 
man: display on-line man pages. 
man page databases. 
man pages. 
manage binary search trees.... 
manage hash search tables... 
manage options for a transport. 
management... 


..makedev(1M) 


— makekey(1) 
makealiases(1M) 
..malloc(3X) 
malloc(3C) 
malloc(3X) 
malloc(3X) 


“hsearch(3C) 
..-t_optmgmt(3N) 
passmgmt(1M) 


MANAGEMENL....sescceesersesesessroeecsessesecacarensnensensenentenente sigset(2) 
management functions. ..format(1M) 
manager, updates text files in ISIS. -isismgr(1M) 
manipulating program. ...ssecssesesseesesseresseessereserreeerrrenes mt(1) 
mapping devices ......++4+ pmap(1M) 
mark single-process code section... .m_single(3PPS) 
mask... »umask(1) 
mask... ..umask(2) 
match patterns against a string. .regex(1F) 
match routines... .regexp(5) 
math functions and constants ...math(5) 
math: math functions and constants .... math(5) 
matherr: error-handling function matherr(3M) 
mbad: MULITBUS adapter... .-mbad(7) 


mcs: manipulate the object file.. 
mem, kmem: core memory... 
member of an archive file 
membership .....ss0scseveeseees 
memccpy, memchr, mememp, memepy,. 
memchr, memcmp, memepy, memset:. 
memcmp, memcpy, memset: memory.. 
memepy, memset: memory operations 
memory... 
memory.. 
memory... 
memory... 
memory allocator. 
memory allocator. 
memory allocator 
memory allocator... 
memory control operations.. 
memory drivers... 
memory dump..... 
memory efficient way 


‘plock(2) 


“shmalloc(3PPS) 
.-valloc(3SEQ) 

its shmet](2) 
consmem(7) 
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queue, semaphore set, or shared 
memcpy, memset: memory operations 
memchr, memcmp, memcpy, memset: 
shmop, shmat, shmdt: shared 

vmtune: tune system-wide virtual- 
shmiget: get shared 

vm_ctl: examine and change virtual 
memccpy, memchr, mememp, memcpy, 
addcmdopt: add a command option to a 
add a form/SELECT window option to a 
addmenuopt: add a menu option to a 
sysadm: 

a list of the currently marked 


menumsg: route user message to 
Tmvopt: remove a 

addmenuopt: add a 

menu: 

of printer types supported by the 
tfmenush: assign 

syskeymap: identify keys to internal 
message queue 

for generating/modifying ASSIST 
merge: three-way file 

sort; sort and/or 

acctmerg: 

resmerge: 

subsequent lines of one file _— paste: 


t_error: produce error 

tfnotify: send completion 

msgctl: 

message: puts its arguments on 
getmsg: get next 

putmsg: send a 

msgop: 

mailx: interactive 

message line 

menumsg: route user message to menu 
msgget: get 

shared memory ID ipcrm: remove a 
errormsg: error 

menumsg: route user 

motd: 

mesg: permit or deny 

sys_errlist, sys_nerr: system error 
strace: print STREAMS trace 

rlog: print log 

dmesg: collect system diagnostic 
parallel 

identification 
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..iperm(1) 
-memory(3C) 
-memory(3C) 


memory: memccpy, memchr, mememp, 
memory operations.. 
memory operations... 
memory parameters 
memory segment identifier. 
memory tuning parameters 


agers shmget(2) 
.vmo_ct](2SEQ) 


memset: memory operations... -memory(3C) 
menu... .-addemdopt(1M) 
menu.. .addformopt(1M) 
menu.. ..addmenuopt(1M) 
menu interface to do system administration.......sysadm(1) 
menu items getitems(1F) 


menu: menu processor «menu(1M) 
menu message queue. menumsg(1M) 
MON OPUOM xe cnscsncecssacescacercsccsescesnssncasvesessesacsesaise rmvopt(1M) 
menu option to a menu. addmenuopt(1M) 


-menu(1M) 


.lptypes(4) 
a 1M) 


menu processor. 
menu system...... 
menu system as user login shell. 
menu system functions............ 
menumsg: route user message to menu.. 
menus or command forms 


vacctmerg(1M) 
-resmerge(1) 
... paste(1) 


merge or add total accounting files.. 
merge RCS revisions 
merge same lines of several files or... 
merge: three-way file merge 
mesg: permit or deny messages... 
message 
message 
message control operations.. 
message line... 
message off a stream... 
message on a stream.. 
message operations. 
message processing system... 
message: puts its arguments on. 
message queue 
message queue.... 
message queue, semaphore set, or. 
message text file..... 
message to menu message queue. 
message-of-the-day file..........es00 

messages. 
messages... 
messages... 
messages and other information about RCS files akan rlog(1) 


.tfnotify(1M) 
.-msgctl(2) 
message(1F) 
-getmsg(2) 
.putmsg(2) 
msgop(2) 
...mailx(1) 
message(1F) 
menumsg(1M) 
-msgget(2) 
iperm(1) 
.errormsg(4) 


messages to form error log. dmesg(1M) 
m_fork: execute a subprogram in.. -m_fork(3PPS) 
m_get_myid: return process......s.scsssssees m_get_myid(3PPS) 
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number of child processes 

getusclk, usclk_init: get/init 

usclk: 32-bit 

aging, PFF, swapping, or processor 
clone: open any 

‘convert between major/ 

/acctwtmp: overview of accounting and 
intro: introduction to 


special or ordinary file 
password lookup 


/gmtime, asctime, cftime, ascftime, 


processs address space 


section m_single, 


configuration file 

chmod: change 

umask: set file-creation 

chmod: change 

cpset: copy file and set 

getty: set terminal type, 
uugetty: set terminal type, 
frexp, Idexp, 

utime: set file access and 
touch: update access and 
astgen: program for generating/ 
printer canonical processing 
SSM: System Services 

Interface cooperating STREAMS 
read/write interface STREAMS 
mod_config: format of a 
/ckpacct, dodisk, lastlogin, 
helplog: 


monitor: 
atime 


mount: 
mount, umount: 


setmnt: establish 
filesystems 
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m_get_numprocs: return... m_get_numprocs(3PPS) 
microsecond clock..... getusclk(3SEQ) 
MMICTOSECON COUNLET.......ecessessorsccsserecsceessonsssesatenseneses usclk(7) 
migration disabled... -noage(1M) 
minor device on a STREAMS driver .--clone(7) 
minor numbers and tty names. .-dev_to_ttyname(3C) 
miscellaneous accounting commands 


mkdir: make a directory. 
mkdir: make directories.. 


mkfifo: make a FIFO special file... “mkfifo(3C) 


mkfs: construct a filesystem .. mkfs(1M) 
m_kill_procs: kill child processe |_procs(3PPS) 
mknod: build special file.......... mknod(1M) 
mknod: make a directory, or a. ..mknod(2) 
mkpwdbm: make a database for fast. mkpwdbm(1M) 
mktemp: make a unique filename..... mktemp(3C) 
mktime, tzset: convert date and time/. ..ctime(3C) 
mkvtoc: populate VTOC on diskS.........» mkvtoc( 1M) 


m_lock, m_unlock: lock, unlock locks.. 
mmap: map an open file into the..... 
m_multi: mark single-process code 
m_next: increment global counter.. 
mnttab: mounted filesystem table . 
mod_config: format of a module.. 


mode mask... 
mode of file.. 
mode, user, and group IDs.. 
modes, speed, and line discipline. 
modes, speed, and line discipline ........s00 
modf: manipulate parts of floating-point/. 
modification times.......... ie 
modification times of a file... 
modifying ASSIST menus or comman 
module.. 
Module... 


..uugetty(1M) 
frexp(3C) 
.utime(2) 
..touch(1) 
astgen(1) 
.lpmod(7) 


module configuration file 
monacct, nulladm, pretmp, prdaily/.. 
monitor help actionS.........00« 
monitor: monitor system activity .. 
monitor: prepare execution profile 
monitor system Activity ......sscerereees 
more: view a file one full screen at, 
motd: message-of-the-day file.. 
mount a filesystem... 
mount and unmount filesystems 
mount: mount a filesystem 
mount table a 
mount, umount: mount and unmount... 


.-helplog(4) 
.«monitor(1M) 
monitor(3C) 
..€monitor(1M) 


-mount(2) 
.mount(1M) 


mount(1M) 
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mountall, umountall: 

multiple filesystems 

muttab: 

mvdir: 

cp, ln, mv: copy, link or 

lseek: 

start/stop the LP print service and 
and resume child process execution 
ptrace, 

drand48, erand48, lrand48, nrand48, 
child process/ m_park_procs, 
processes 


single-process code section 


program 
st: Systech 


mbad: 

xt: Xylogics 472 

kMBmem, kMWmem: 

mountall, umountall: mount, unmount 
poll: STREAMS input/output 

Systech MTI-800/1600/1650 terminal 
xs: Xylogics 781 terminal 

tmp_ctl: 

rc2: run commands performed for 
m_lock, 

address space 

cp, In, 


devnm: device 

getenv: return value for environment 
getgeombyname: get disk geometry by 
getlogin: get login 

logname: get login 

pwd: working directory 

tmpnam, tempnam: create a 

table/ 1dgetname: retrieve symbol 
getpw: get 

nlist: get entries from 

rename: change the 

ttyname, isatty: find 

uname: get 

uname: print 

tty: get the 

cuserid: get character login 

logname: return login 

Adnshread: read an indexed 
Adusseek: seek to an indexed 
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mount, unmount multiple filesystema............ mountall(1M) 
mountall, umountall: mount, unmount. -mountall(1M) 
mounted filesystem table. ...mnttab(4) 
move a directory .. 


move files... cp(1) 
move read/write file pointer lseek(2) 
MOVE TEQUESES.....sccsersessceseeres lpsched(1M) 


m_park_procs, m_rele_procs: susp/....m_park_procs(3PPS) 
mptrace: process trace facility ptrace(2) 
mrand48, jrand48, srand48, seed48,/.. drand48(3C) 
m_rele_procs: suspend and resume....m_park_procs(3PPS) 
m_set_procs: set number of child...........m_set_procs(3PPS) 
msgctl]: message control operations.. 3 

msgget: get message queue.. 
msgop: message operations 
m_single, m_multi: mark.. 
m_sync: check in at barrier 
mt: magnetic tape manipulating. 
MTI-800/1600/1660 terminal multiplexor driver......... st(7) 
mtio: UNIX magnetic tape interface 


MULITBUS adapte’.......ssssssseseresseees mbad(7) 
MULITBUS magnetic tape interface. -xt(7) 
MULITBUS memory... mmem(7) 
multiple filesystems.. -mountall(1M) 


MUI ti PlEXiNg ....ssseccscsessseessssnsssscceessnseesncsseseenserenreneeseeeeee poll(2) 
multiplexor driver. se 

multiplexor driver... 
multi-processor control 
multi-user environment... 
m_unlock: lock, unlock locks.. 
munmap: unmap part of the processs. 
mv: copy, link or move files. 
mvdir: move a directory 


a sneesT02(1M) 


name 
name "getgeombyname(3SEQ) 
name ...getlogin(3C) 


.-logname(1) 


name of a terminal ttyname(3C) 


name of current operating SYStEM.......ecsssscseeeeeeee uname(2) 
name of current system. .uname(1) 
name Of the terminall........ccsssessssssssecsssssscsssssscerssscneoeerses tty(1) 
name of the user. cuserid(3S) 


name of user. 
named section header of a common obje 
named section of a common object file 
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Ld 


between major/minor numbers and tty 
id: print user and group IDs and 

term: conventional 

isnanf: test for floating-point 
processing language 

and indirect blocks 

of filesystems processed by feck and 
i-numbers 

uucp: 

file 


news: print 


getmsg: get 


object file 
command with priority aging, PFF/ 
hangups and quits 

setjmp, longjmp: 

sigsetjmp, siglongjmp: 

with priority aging, PFF/ noage, 
priority aging, PFF/ _—noage, nopff, 
test for floating-point NaN 

seed48/ drand48, erand48, lrand48, 
deroff: remove 
machid: i386, 
null: the 


vax: get processor/ 


/ckpacct, dodisk, lastlogin, monacct, 
obtain the prime factors of a 
getfrm: returns the current frame 
test for floating-point NaN (Not-A- 
convert string to double-precision 
linenum: line 

Adlinit, ldlitem: manipulate line 
ldlseek, Idnlseek: seek to line 

rand, srand: simple random- 
nblocks: calculate 
m_get_numprocs: return 
m_set_procs: set 

cpus_online: returns the 

df: report 

fevt, gevt: convert floating-point 

nl: line 

uniformly distributed pseudorandom 
manipulate parts of floating-point 
install random inode generation 

to system calls and error 


38 


dev_to_ttyname(3C) 
seid (1M) 


names for terminals. 
NaN (Not-A-Number). 
nawk: pattern scanning and 
nblocks: calculate number of blocks.. 
ncheck. 
ncheck: generate pathnames from 
networking support files...........s00 
newform: change the format of a text... 
newfs: construct a new file system 
newgrp: log in to a new group. 
DEWS itOMS....ecereresenenenees 
news: print news items... 
next message off a stream 
nice: change priority of a process... 
nice: run a command at low priority 
nl: line numbering filter.........+0 
nlist: get entries from name list. “nlist(3C) 
nm: print name list of............8ee C and Lang Tools Binder 
noage, nopff, noswap, onproc: run a... -noage(1M) 
nohup: run a command immune to snohup(1) 
non-local goto... .setjmp(3C) 
non-local jumps... sigsetjmp(3C) 
nopff, noswap, onproc: run a comman -noage(1M) 
noswap, onproc: run a command with.. -noage(1M) 
(Not-A-Numbe7).....ssssesesssseseseesseeseeseen ..isnan(3C) 
nrand48, mrand48, jrand4, srand48,.. .drand48(3C) 
nroff, tbl, and eqn constructs... 
ns32000, pdp11, u3b, u3b2, u3bb5, 
null file......scsseeee 


-nblocks(3SEQ) 
checklist(4) 
...ncheck(1M) 


.-machid(1) 
.null(7) 


null: the null file.... -null(7) 
nulladm, pretmp, prdaily, prtac -acctsh(1M) 
number... .factor(1) 
numbe’ .getfrm(1F) 
Number) ...isnan(3C) 
number... ..strtod(3C) 
number entries in a common object file -linenum(4) 
number entries of a common object/. Idlread(3X) 
number entries of a section of @/.... ....ldlseek(3X) 
number generator. rand(3C) 


number of blocks and indirect blocks...........nblocks(3SEQ) 
number of child processes... m_get_numprocs(3PPS) 
number of child processes. ....™_set_procs(3PPS) 
number of CPUs on-line... oe 
number of free disk blocks and inodes.. 

number to string.. 
numbering filter. 
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@ ncheck: generate pathnames from i- 
‘convert between major/minor 


cprs: compress an 
strstr: find first 
od: 


offline: bring processors online and 
online, 

processor off line 

online, offline: bring processors 
online and offline 

aging, PFF/ _noage, nopff, noswap, 
Idopen, Idaopen: 

fopen, freopen, fdopen: 

clone: 

dup: duplicate an 

dup2: duplicate an 

mmap: map an 

open: 


rewinddir, closedir/ directory: 

a standalone program or bring up the 

run commands performed to stop the 
savecore: save a core dump of the 

uname: get name of current 

© locate: use keywords to identify an 
assist: assistance using 

starter: information about the 

help: 

glossary: definitions of common 

join: relational database 

curses: terminal screen handling and 

rmvopt: remove a menu 

getopt: get 

addcemdopt: add a command 

addformopt: add a form/SELECT window 
addmenuopt: add a menu 

object file ldohseek: seek to the 

fentl: file control 

getopt: parse command 

getopts, getoptcvt: parse command 

stty: set the 

t_optmgmt: manage 

make a directory, or a special or 

architecture information 

common assembler and link editor 

echo: put string on virtual 

fread, fwrite: binary input/ 

fprintf, sprintf: print formatted 

; poll: STREAMS input/ 
| /vfprintf, vsprintf: print formatted 
© stdio: standard buffered input/ 
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ncheck(1M) 
dev_to_ttyname(3C) 


numbers and tty names 


object file see C and Lang Tools Binder 
occurrence of character. stratr(3C) 
octal dump.... ay 

od: octal dump... 


offline: bring processors online and offline 
offline_all: take all but one active... 

online and offline 
online, offline: bring processors... 
onproc: run a command with priority... 
open a common object file for reading.. 
OPEN A SLTEAM.......ccsessssssscsenacersseeseneeeeres 
open any minor device on a STREAMS driver. 
open file descriptor........ daneaathes 
open file descriptor... 
open file into the processs address space. 
open for reading or WTriting.........s.ssssssee s 
open: open for reading or writing. 
opendir, readdir, telldir, seekdir,... 
operating system... 
operating system.. 
operating system.. 
operating system... 
operating system command. 
operating system commands... 
operating system for beginning users... 
operating system Help Facility............. 
operating system terms and symbols. 
operator.......... aesnnsseeeeee 
optimization package. 


«+«1CO(1M) 
.savecore(1M) 
-uname(2) 


option to a menu.. 
option to a menu... 
option to a menu..... 
optional file header of a common.. 
options... 
options... 
options. 
options for a terminal 
options for a transport endpoint 
ordinary file.......c.sccesseees 
ott: files that hold object. 


.addmenuopt(1M) 
..ldohseek(3X) 


-fread(3S) 
print{{3S) 
.»poll(2) 
-vprint{(3S) 
stdio(3S) 


output... 
output multiplexing............. 


output of a varargs argument list... 
output package. 
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setpgrp: run command in its 
chown: change 

chown, chgrp: change 

expand files 

makewhatis: generate man 
getpagesize: get system 

4014: 

m_fork: execute a subprogram in 
Ip: Systech 

wp: SSM 

Ipmod: 

intro: introduction to 

and change virtual memory tuning 
tune system-wide virtual-memory 
pmap: display or alter 

get process, process group, and 
getopt: 

getopts, getoptcvt: 

cmpt: compatibility 

vtoc: VTOC 

frexp, ldexp, modf: manipulate 


with information from /etc/ 
password attributes 


getpass: read a 

crypt: 

passwd: change login 

passwd: change login password and 
pwdhd: daemon to oversee 

pwfix: remove incorrectly formatted 
passwd: 

shadow: restricted 

setpwent, endpwent, fgetpwent: get 
Ickpwdf, ulckpwdf: get shadow 
putpwent: write 

putspent: write shadow 

converts from a two to a one 
passmgmt: 

mkpwdbm: make a database for fast 
pwek, grpck: 

files or subsequent lines of one/ 

bp: binary 


configurable pathname variables 
criteria for filename 

getewd: get 

fpathconf: get configurable 
dirname: deliver portions of 
ncheck: generate 

sweepon, sweepoff: enable/disable 
grep: search a file fora 
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own process group. 

owner and group of a file.. 

OWNEY OF QTOUP.......cseceeeee chown(1) 
pack, peat, unpack: compress and... .»pack(1) 
page databases. makealiases(1M) 
PAQE SIZE ...cessvsececerssssssessrerereresererseeteneetssers getpagesize(2SEQ) 
paginator for the Tektronix 4014 terminal.............. 4014(1) 


..m_fork(3PPS) 


parallel line printer interface 
parallel line printer interface... 
parallel printer canonical processing module. 
Parallel Programming Library .....esssssscsseeeee i 
parameters.. ..vm_ctl(2SEQ) 
parameters... .vmtune(1M) 
parameters of virtual-to-physical mapping/........pmap(1M) 
parent process IDs. getpid(2) 
parse command option getopt(1) 
parse command options.. ..getopts(1) 
partitioning driver.... aa 
partitioning driver... 
parts of floating-point numbers 
passmgmt: password files management. 
passwd... 
passwd: change login password an 
passwd: password file .. 
PASSWOTGE wosccssssessesesseerees 
password and file encryption functions. 
password and password attributes. 
password attributes... 
password database creation. 
password entries 
password file... 
password file... 
password file entry... 
password file entry 
password file entry 
password file entry 
password file scheme 
password files management.. 
password lookup........ssesseree 
password/group file checkers... 
paste: merge same lines of several.. 


. Shadow(4) 
getpwent(3C) 
.getspent(3X) 
putpwent(3C) 
.... putspent(3X) 
..pwunconv(1M) 


pathalias: alias file for FACE. 
pathconf, fpathconf: get...... 
pathconv: search Interpreter. 


pathnames from i-numbers 
patrol seeks on DCC disks.. 
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awk: 
nawk: 


egrep: search a file for a 


regex: 


match 


pack, 
popen, 


machid: i386, ns32000, 
sigpending: examine 
check the uucp directories and 


acct: 


acctcms; command summary from 
sys8_nerr: system error messages 


run a command with priority 


aging, 


virtual address space pmap: map 
or alter parameters of virtual-to- 


sp: STREAMS 


popen, pclose: i 


tee: 
nitiate 


in memory 


virtual-to-physical mapping devices 
processs virtual address space 
/fpsetsticky: IEEE floating- 

isnand, isnanf: test for floating- 
ecvt, fevt, gcvt: convert floating- 
modf: manipulate parts of floating- 
lseek: move read/write file 


rewind, ftell: repositio: 


n a file 


multiplexing 

a process 

banner: make 

power, square root/_ exp, log, log10, 
pow, sqrt: exponential, logarithm, 


/dodisk, lastlogin, monacct, nulladm, 
Aastlogin, monacct, nulladm, pretmp, 
be; arbitrary- 

atof: convert string to double- 
environ, 

monitor: 

cpp: the C language 

factor: obtain the 

gps: graphical 
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types: 
prs: 
date: 
cal: 


pattern scanning and processing language.. 
pattern scanning and processing language 
pattern using full regulary... 
patterns against a string.... 
pause: suspend process until signal. 
peat, unpack: compress and expand files 
pclose: initiate pipe to/from a process. a 
pdbx, dbx: parallel... see C and Lang Tools Binder 
pdp11, u3b, u3b2, u3b5, vax: get processor/......... machid(1) 
pending signals... .8igpending(2) 
permissions file..... 
per-process accounting file format....sssssssesseseeeeseees 
per-process accounting records 
perror, errno, sys_errlist, 
PFF, swapping, or processor/.. 
pg: file perusal filter for CRTs. 
physical] addresses into processs 
physical mapping devices........... 
pipe: create an interprocess channel 


Pipe device ......sesseseeees sesabansseasenessasnd 0 sp(7) 
Pipe fitting.........see .tee(1) 
pipe to/from a process. pasties popen(3S) 


plock: lock process, text, or data 
plot: graphics interface. 
plot: graphics interface subroutines. 
pmap: display or alter parameters of... 
pmap: map physical addresses into. 
point environment control... 
point NaN (Not-A-Number).. 
point number to string 
point numbers.. 
pointer.........0. 
pointer in a stream.. 


poll: STREAMS input/output... .»-poll(2) 
popen, pclose: initiate pipe to/from... popen(3S) 
WOOBLOTS issscccsszcccscessaccsscacsegsecivecersseaenes ,banner(1) 
pow, sqrt: exponential, logarithm, exp(3M) 


power, square root functions. exp(3M) 
preprint Gleb csscssccsaisinsncnsacsnmammsaanmnesemenccend pr(1) 
prcetmp, prdaily, prtacct, shutacct//... .acctsh(1M) 
prdaily, prtacct, shutacct, startup/.. 
precision arithmetic language.........ssssscsssssssenseessseersesee be(1) 
precision number........... oe 
opref, .variables: FACE files.......ssssscscsscsssessssessesreseseenes 
prepare execution profile... 
PTEPTOCESBOF ....eseesesecseeene 
prime factors of a number 
primitive string, format of graphical files.. 
primitive system data types. 
print an SCCs file......... 
print and set the date 
print calendar 
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sum: 
sact: 

cat: concatenate and 

pr: 

printf, fprintf, sprintf: 

vprintf, vfprintf, vsprintf: 

of the LP print service Ipstat: 
information about RCS files rlog: 
object file nm: 
uname: 

news: 

infocmp: compare or 

acctcom: search and 

of object files size: 
send/cancel requests to the LP 
Ipadmin: configure the LP 
administer filters used with the LP 
administer forms used with the LP 
about the status of the LP 

Apshut, lpmove: start/stop the LP 
strace: 


Ipmod: parallel 

Ip: Systech parallel line 

wp: SSM parallel line 

Iptypes: table of 

enable, disable: enable/disable LP 
formatted output 

Ipusers: set 

Ipusers: set printing queue 

nice: run a command at low 
/noswap, onproc: run a command with 
nice: change 

brk, sbrk: change 

process attributes 

codestroy: communicate to a 

exit, exit: terminate 

fork: create a new 

inittab: script for the init 

kill: terminate a 

nice: change priority of a 

pclose: initiate pipe to/from a 
wait: await completion of 

acct: enable or disable 

acctprel, acctpre2: 

acct: per- 

acctcom: search and print 
acctcms: command summary from per- 
alarm: set a 

times: get 


42 


print checksum and block count of a file.. 
print current SCCS file editing activity 
print files... 
print files. 
print formatted output. 
print formatted output of a varargs/. 
print information about the status.. 
print log messages and other. 
print name list of...........ssseee 
print name of current system 
PFrint news iteMS ......scseeeeeees 
print out terminfo descriptions 
print process accounting files. 
print section sizes. 
print service... 
print service.... 
print service... 
print service 
print service... 
print service and move requests. 
print STREAMS trace messages 
print the VTOC of a block device... 
print the VTOC of a standalone disk device. 
print user and group IDs and names... 
printer canonical processing module. 
printer interface... 
printer interface .. 


»«Sum(1) 
.sact(1) 


-] 
. Tlog(1) 


“infocmp( 1M) 
.»acctcom(1) 


lpadmin(1M) 
..-lpfilter(1M) 
..lpforms(1M) 
eaaee Tpstat(1) 
.. lpsched(1M) 
«strace(1M) 


ater fprintf, sprintf: print... 
printing queue priorities 


priorities... pusers(1M) 
priority... ««enice(1) 
priority aging, PFF, swapping, or/.. -noage(1M) 
priority of a process........ .nice(2) 


..brk(3PPS) 
proc_ctl(2SEQ) 
..coproc(1F) 
».exit(2) 
.fork(2) 
inittab(4) 


private data segment size... 
proc_ct]: control over various. 
process... 
process... 
process .. 
process.. 
process... 
process .. 
process... 


process accounting... 
process accounting file format. 
process accounting files..... 
process accounting records 
process alarm clock............ 
process and child process times....... 
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proc_ctl: control over various 
m_single, m_multi: mark single- 
ipes: report inter- 

init, telinit: 

timex: time a command; report 
suspend and resume child 
setpgrp: run command in its own 
/getpgrp, getppid: get process, 
setpgrp: set 

setsid: create session and set 
tegetpgrp: get foreground 
tesetpgrp: set foreground 
m_get_myid: return 

process, process group, and parent 


vfork: spawn new 


kill: send a signal toa 

getpid, getpgrp, getppid: get 

ps: report 

plock: lock 

times: get process and child 
tmp_aflinity: bind a 

wait, waitpid: wait for a child 
ptrace, mptrace: 

pause: suspend 

vsig: synchronize a co- 

checklist: list of filesystems 

a signal to a process or a group of 
killall: kill all active 

return number of child 
m_kill_procs: kill child 
m_set_procs: set number of child 
fuser: identify 

m4: macro 

menu: menu 

tmp_affinity: bind a process to a 
tmp_ctl: multi- 

priority aging, PFF, swapping, or 
offline_all: take all but one active 
pdp1l, u3b, u3b2, u3b5, vax: get 
online, offline: bring 

mmap: map an open file into the 
munmap: unmap part of the 
pmap: map physical addresses into 


monitor: prepare execution 
profil: execution time 

prof: display 

at login time 

prof: 
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process attributes... 
process code section 
process communication facilities 
process control initialization..... 
process data and system activity... 
process execution... 
process group. 
process group, and parent process IDs 


..proc_ctl(2SEQ) 
pie 


PYOCESB QTOUP ID...cssssesscssssssssesssenseorees setpgrp(2) 
process group ID... setsid(2) 
process group ID. tegetpgrp(2) 
process group ID... pen oe 
process identification 

process IDB.......... ones 


process in a virtual memory efficient way.. ~_..wfork(2) 


process or a group of processes.. kill(2) 
process, process group, and parent/. .getpid(2) 
PYOCEBS SLALUS.......sescserecscsessserescscseressssescsesesseeeeeterenetereree ps(1) 
process, text, or data in memory. plock(2) 
PYOCCSS LINC. scscscseseiosisetcovsssevesseasascssseoresseseadaasasioinvad times(2) 
process to a processor. .tmp_affinity(2SEQ) 


process to Stop OF terMiNAte.....ssserersseessesseresseeseencresses wait(2) 
process trace facility.. .-ptrace(2) 
process until signal... pause(2) 
process with the controlling FMLI object . V8ig(1F) 
processed by feck and ncheck.. .checklist(4) 
«kill(2) 
= illall(1M) 
aa pats numprocs(3PPS) 
.m_kill_proca(3PPS) 
..m_set_proca(3PPS) 
-fuser(1M) 


processes using a file or file structure. 
PTOCCSSOL ..sseseesecneessersees ais sanasesinasamscinaies 
processor..... 
processor... 
processor control.. 


.tmp_affinity(2SEQ) 
..tmp_ctl(2SEQ) 


processor migration disabled.. ..-noage(1M) 
processor Off line........s0++ ne_all(3SEQ) 
processor type truth value ..-machid(1) 
processors online and offline .online(1M) 
processs address space... ....mamap(2SEQ) 
processs address space... munmap(2SEQ) 
processs Virtual address SPACEC.........sss-secsccesssesssecesens pmap(7) 


product: installed products file... 
prof: display profile data...... 


prof: profile within a function. profs) 
profil: execution time profile profil(2) 
profile... monitor(3C) 
profile... ..«profil(2) 


profile data 
profile: setting up an environment 
profile within a function. 
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end, etext, edata: last locations in 
mt: magnetic tape manipulating 
prompt: prompt 

sdiff: side-by-side difference 
STREAMS error logger cleanup 

units: conversion 

for the uucp file transport 

assert: verify 

ASSIST menus or command/ astgen: 
uucico: file transport 

installboot: installs a boot 

boot: run a standalone 

a standard/restricted command/ 

the standard/restricted command 
intro: introduction to Parallel 
maintenance commands and application 
update, and regenerate groups of 
lex: generate 

setlocale: set 

prompt: 


t_getinfo: get 
proto: 


/monacct, nulladm, pretmp, prdaily, 
device 
standalone disk device 


streampty: STREAMS 

getpseudotty: get 

cn: 

generate uniformly distributed 
time, 

facility 

uuto, uupick: 

ungetc: 

puts, fputs: 

pute, putchar, fputc, putw: 
getdents: read directory entries and 
echo: 

character or word on a stream 

or word on a stream pute, 
environment 


stream 

message: 

entry 

getut: getutent, getutid, getutline, 
pute, putchar, fputc, 

checkers 


-uusched(1M) 
program assertion ..assert(3X) 
program for generating/modifying. 


program for the uucp system 


program on a disk 
program or bring up the operating system.. boot(8) 
programming language... 


programming language 
Programming Library... 
programs... 
programs.. 
programs for simple lexical tasks. 
programs location. 
prompt program..... 
prompt: prompt program 
proto: prototype job file for at. 
protocol-specific service information... 
prototype job file for at... 
prs: print an SCCS file... 
prtacct, shutacct, startup/. 
prtvtoc: print the VTOC of a 
prtvtoc: print the VTOC of a 
ps: report process status. 
pseudo terminal driver. 
pseudo terminals....... 


setlocale(3C) 
..prompt(1M) 
..prompt(1M) 


streampty(7) 
..getpseudotty(3SEQ) 


pseudoconsole driver ..t.ssssssccssssssesscssssecsssssesesssserseeacseenes .cn(7) 
pseudorandom numbers... drand48(3C) 
ptime: time a command.. ..time(1) 
ptrace, mptrace: process trace.. ptrace(2) 
public UNIX-to-UNIX system file copy uuto(1C) 
push character back into input stream. -ungetc(3S) 
put a string On & StreaM.....eeseseseees .puts(3S) 
put character or word on a stream.. -pute(3S) 
put in a file system independent/ getdents(2) 
put string on virtual output...... -echo(1F) 


pute, putchar, fpute, putw: put. 
putchar, fputc, putw: put character 
putenv: change or add value to. 
putmsg: send a message on a stream. 


putpwent: write password file entry. putpwent(3C) 


puts, fputs: put a string on a. «+e puts(3S) 
puts its arguments on message line “message(1F) 
putspent: write shadow password file putspent(3X) 
pututline, setutent, endutent/........0-. .-getut(3C) 


.putc(3S) 
..pwek(1M) 


putw: put character or word on a stream.. 
pwck, grpck: password/group file 
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@& /etc/shadow with information from/ 


database creation 
password entries 
one password file scheme 


tput: initialize a terminal or 

route user message to menu message 
msgget: get message 

Ipusers: set printing 

ipcrm: remove a message 
quotacheck: filesystem 


consistency checker 


quotaon, 

quotas on and off 

edquota: edit user 

quotactl: manipulate disk 
repquota: summarize 

quotaon, quotaoff: turn filesystem 
generator 

fsirand: install 

rand, srand; simple 


faplit: split 77, 
@ ratfor: 


scripts 
the operating system 
multi-user environment 


resintro: introduction to 

resfile: format of 

res: change 

sccstores: build 

messages and other information about 
ci: check in 

co: check out 

resdiff: compare 

resmerge: merge 


commands 
getpass: 


of a common object file ldtbread: 
header of a/ ldshread, Idnshread: 


structure read_constab: 
file system independent/ getdents: 
read: 


mail, rmail: send mail to users or 
line: 
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pweonv: installs and updates 
pwd: working directory name.... 
pwdhd: daemon to oversee password.... 
pwfix: remove incorrectly formatted. 
pwunconv: converts from a two to a. 
qsort: quicker sort... 
query terminfo database. 


queue.... 


sskiss tput(1) 
menumsg(1M) 


queve.. msgget(2) 
QUEUE PFIOTIties..........cecesseseceresseeeeessseseceesneneneereees Ipusers(1M) 
queue, semaphore set, or shared memory ID.......... iperm(1) 

quotacheck(1M) 


quota: display disk usage and limits ...quota(1) 
quotacheck: filesystem quota......... quotacheck(1M) 
quotactl: manipulate disk quotas.. .quotactl(2SEQ) 


quotaoff: turn filesystem quotas on and off.....quotaon(1M) 
quotaon, quotaoff: turn filesystem. quotaon(1M) 
quotas. 
quotas.. 
quotas for a filesystem... 
quotas on and off........ aes 
rand, srand: simple random-number. 
random inode generation numbers... “feirand(1M) 
random-number generator. 
ratfor, or eff files .........s0000 
ratfor: rational Fortran dialect.. 
rational Fortran dialect... 
re: reboot and shutdown command... 
re0: run commands performed to stop. 
re2: run commands performed for. 
res: change RCS file attributes. 


RCS revisions... 
RCS revisions 
RCS revisions 
RCS revisions 
resdiff: compare RCS revision: 
resfile: format of RCS file...... oT 
rcsintro: introduction to RCS... resintro(1) 
resmerge: merge RCS revisions... resmerge(1) 
Tead & PASSWOTT .....sssssececeeeers -getpass(3C) 
read an indexed symbol table entry. dtbread(3X) 
read an indexednamed section ldshread(3X) 
read constab entries into a...... read_constab(3SEQ) 
read directory entries and put ina .getdents(2) 
read from file -read(2) 
read mail.... -mail(1) 
read one line. .line(1) 
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of an archive file 
object file 


Idahread: 
Idfhread: 
readlink: 

readv: 

into a structure 
directory: opendir, 
gets longest line 
open a common object file for 
open: open for 
link 


readfile, longline: 


lseek: move 

tirdwr: Transport Interface 
/get real user, effective user, 
/geteuid, getgid, getegid: get 
malloc, free, 
malloc, free, 
re: 
t_revudata: 
t_revuderr: 
t_rev: 
t_revconnect: 
lockf: 

ed, 

setcolor: 
ditsectb): 
regular expression 


fast main memory/ 


over a connection 
connect request 


make: maintain, update, and 
expression regcemp, 
string 

and match routines 

regcmp, regex: compile and execute 
regemp: 

regexp: 

a file for a pattern using full 


routines 


accept, 

comm: select or 

join: 

t_sndrel: initiate an orderly 
acknowledge receipt of an orderly 
common object file 

ldrseek, ldnrseek: seek to 
reloc: 

/ceil, fmod, fabs: floor, ceiling, 
calendar: 

uuxqt: execute 

Uutry: try to contact 

ct: spawn getty toa 
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read: read from file 
read the archive header of a member. 
read the file header of a common... 
read value of a symbolic link 
read vector from file.............. ....Teadv(2SEQ) 
read_constab: read constab entries.....read_constab(3SEQ) 
readdir, telldir, seekdir, rewinddir/.. T 
readfile, longline: reads file and. 


.ldfhread(3X) 
readlink(2SEQ) 


reading or writing... 
readlink: read value of a symbolic 
reads file and gets longest line... 
readv: read vector from file... 
read/write file pointer.......... 
read/write interface STREAMS module. 
real group, and effective group IDs... 
real user, effective user, real/......... 
realloc, calloc: main memory allocator 
realloc, calloc, mallopt, mallinfo....... 
reboot and shutdown command scripts. 
receive a data unit 
receive a unit data error indication... 
receive data or expedited data sent.. 
receive the confirmation from a . 


te _revuderr(3N) 
atts t_rev(3N) 
.t_revconnect(3N) 


TEAS CEXE CQLCON scscsccssseccacasinsaccssstuavevscenssvessssnopenersisenastaduses ed(1) 
redefine or create a colo} etcolor(1F) 
refresh security table.... ditsectbl¢(1M) 
regcmp, regex: compile and execute.. regemp(3X) 
regemp: regular expression compile .. regemp(1) 
regenerate groups of program........ make(1) 
regex: compile and execute regula regemp(3X) 
regex: match patterns against a regex(1F) 
regexp: regular expression compi regexp(5) 
regular expression.........+++ regemp(3X) 
regular expression compile.. regemp(1) 
regular expression compile and match. regexp(5) 
regular expressionS...........sssses0 ..egrep(1) 
reinit: run an initialization file... reinit(1F) 
reject: allow or prevent LP requests... accept(1M) 
reject lines common to two sorted files comm(1) 
Telational database Operator ...scsssccsesessescssseseereressenoeres, join(1) 
Te]CAC......ssesceeeenee _sndrel(3N) 
release indication. ..t_revrel(3N) 


reloc: relocation information for a... 
relocation entries of a section of a commo: 
relocation information for a common object file 
remainder, absolute value functions 
reminder service..... 
remote command request 
remote system with debugging on. 
remote terminal 
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rmdel: 
rmdir: 
rmvopt: 
iperm: 
unlink: 
rm, rmdir: 
pwfix: 
deroff: 


set, or shared memory ID 


password entries 


consistency check and interactive 
uniq: report 
clock: 
festat: 

ipes: 

df: 

mailbug: submit a bug 

sar: sal, sa2, sadc: system activity 
timex: time a command; 

ps: 

uniq: 

feeek, rewind, ftell: 

filesystem 

submit a bug report or enhancement 
t_accept: accept a connect 

t_listen: listen for a connect 

the confirmation from a connect 
send user-initiated disconnect 
accept, reject: allow or prevent LP 
the LP print service and move 
uuxqt: execute remote command 

Ip, cancel: send/cancel 
to its default values 
reset: 
get_process_stats: get 
restore: incremental filesystem 
restore 

‘ksh, rksh — KornShell, a standard/ 
sh, rsh: shell, the standard/ 

shadow: 

/m_rele_procs: suspend and 

usage examples usage: 
t_revdis: 

object file symbol table/_ ldgetname: 
abs: 

logname: 

m_get_numprocs;: 

m_get_myid: 
getenv: 

stat: data 
getitems: 
getfrm: 
cpus_online: 


facilities status 


default values 


marked menu items 
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remove a delta from an SCCS file. 
TEMOVE A GITECCOTY....cccccsssssssseeseeers 
TEMOVE A MENU OPtION....ssssscssresseeseee 
remove a message queue, semaphore. 
remove directory entry.... 
remove files or directories... 
remove incorrectly formatte 
remove nroff, tbl, and eqn constructs. 
rename: change the name of a file 


repeated lines in a file.. 
report CPU time used... 
report filesystem status.. 
report inter-process communication 
report number of free disk blocks and inodes... 
report or enhancement request.... 
Teport Pack age ...scssscsessssssesssereees 
report process data and system activity. 
Teport process status ........+000 
report repeated lines in a file... 
reposition a file pointer in a stream 


t_listen(3N) 
..t_reveonnect(3N) 


requests. accept(1M) 
requests. Jpsched(1M) 
requests.. uuxqt(1M) 


requests to the LP print service oe 
reset: reset the current form field 
reset the current form field to its. 
resource utilization info 


.restore(1M) 
restore: incremental filesystem 
restricted command and programming/.. 
restricted command programming/. 
restricted password file.......... 
resume child process execution 
retrieve a command description and... 
retrieve information from disconnect. 
retrieve symbol] name for common... 
return integer absolute value 
return login name of user... 
return number of child procs. 
return process identification... 
return value for environment name 


‘shadow(4) 
m_park_ ee 


logname(3X) 
.m_get_numprocs(3PPS) 
..m_get_myid(3PPS) 
getenv(3C) 


returned by stat system Call ......s.cssssssssssaeessessenersnseaees stat(5) 
returns a list of the currently. getitems(1F) 
returns the current frame number... getfirm(1F) 


returns the number of CPUs on-line 
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col: filter 

ci: check in RCS 

co: check out RCS 

resdiff: compare RCS 

resmerge: merge RCS 

pointer in a stream fseek, 
/opendir, readdir, telldir, seekdir, 
creat: create a new file or 

restricted command/ ksh, 
information about RCS files 
directories 

mail, 

file 


rm, 


chroot: change 

chroot: change 

logarithm, power, square 

queue menumsg: 
ldfen: common object file access 
regular expression compile and match 
programming language 


noage, nopff, noswap, onproc: 

the operating system boot: 
run: 
ede: 
reinit: 
setpgrp: 
re2: 
red: 
runacct: 


multi-user environment 
operating system 


Administration 
sar: 

sar: sal, 
editing activity 
sar: sal, sa2, 
report package 


savecore: 
operating system 
brk, 

brk, 

formatted input 
bfs: big file 

awk: pattern 
nawk: pattern 


: run a command immune to hangups and quits 
: run a command using shell 


reverse line-feeds.. 
revisions.... 
revisions... 


rewind, ftell: reposition a file... ...fseek(3S) 
rewinddir, closedir: directory/. .directory(3X) 
rewrite an existing one......... 


.creat(2) 


rksh: KornShell, a standard/. ksh(1) 
rlog: print log messages and other. rlog(1) 
rm, rmdir: remove files OF........sss0+ rm(1) 


-mail(1) 
..rmdel(1) 


rmail: send mail to users or read mail. 
rmdel: remove a delta from an SCCS. 


rmdir: remove a directory... ..rmdir(2) 
rmdir: remove files or directories .......csssssesscsceeeseeserene rm(1) 
rmvopt: remove a menu option... 

TOOt GIFECtOry....sesecsecssssesesserseers chroot(2) 


root directory for a command.. .chroot(1M) 
TOOt FUNCTIONS.........scecereseeeeeeeeres 
route user message to menu message.. 
routines... 
routines.... 
rsh: shell, standard/restricted command/, 


Tun 8 command at JOW priority .....ccsscneereeeseeeneeeee 


run a command with priority aging, PFF/. 
run a standalone program or bring up. 
TUN AN EXCCULADLE......ccseersesreneesssereerers 
run an externally described command. 
TUN an initialization file........ssseenecnees 
run command in its own process group 
run commands performed for........00« 
run commands performed to stop the 
run daily accounting....... 
run: run an executable .. 
runacct: run daily accounting. 
SA: devices administered by System... 
sal, sa2, sadc: system activity report package. 
sa2, sadc: system activity report packag: 
sact: print current SCCS file.... 
sade: system activity report package 
sar: sal, sa2, sadc: system activity 


sar: system activity reporter.......... 8ar(1) 
gave a core dump of the operating aystem......savecore(1M) 
savecore: save a core dump of the .savecore(1M) 


sbrk: change data segment space allocation. 
sbrk: change private data segment size 
scanf, fecanf, sscanf: convert 
SCADNET..accsescssocssesorssesonssnesnenes 
scanning and processing language 
scanning and processing language... 
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change the delta commentary of an 
comb: combine 

delta: make a delta (change) to an 
get: get a version of an 

prs: print an 

rmdel: remove a delta from an 
scesdiff: compare two versions of an 
sccsfile: format of 

sccstorcs: build RCS file from 
unget: undo a previous get of an 
val: validate 

sact: print current 

admin: create and administer 
what: identify 

SCCS file 


file 

board 

ckbupscd: check filesystem backup 
transport program uusched: the 
unlock locks s_init_lock, s_lock, 
object file 

image file 

more: view a file one full 

curses: terminal 

scr_dump: format of curses 

vi: 

inittab: 

re: reboot and shutdown command 
tg: 

sd: 

wd: SSM 

CCSformat: standalone embedded 
tm: 


ts: SCSI tape controller. 


SCED: 
getscsiinfo, getscsimatch: get 


program 

fgrep: 

grep: 

full regular expressions egrep: 
bsearch: binary 

acctcom: 

lsearch, I find: linear 

pathconv: 

hcreate, hdestroy: manage hash 
tfind, tdelete, twalk: manage binary 
manipulate the object file comment 
m_multi: mark single-process code 
senhdr: 

Adnshread: read an indexednamed 
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sccsdiff: compare two versions of an... 
sccsfile: format of SCCS file 
sccstorcs: build RCS file from SCCS.. 
SCED: SCSI/Ethernet/Diagnostic 
BCHEMUIE.......sssesssecsesveveveenenen 
scheduler for the uucp file. 
s_clock, s_unlock: initialize, lock, 
senhdr: section header for a common. 
scr_dump: format of curses screen.. 
screen at a time.... 
screen handling and optimization package... 
screen image file scr_dump(4) 
screen-oriented (visual) display editor based on ex......vi(1) 
script for the init process...... -inittab(4) 
BCTIPtS ...ceseserssserseesseaceceeeeeneee 
SCSI 1/2-inch magnetic tape interface 
SCSI disk controller.. 
SCSI disk controller. 
SCSI disk formatter... 
SCSI tape controller. 


SCSI/Ethernet/Diagnostics board 
scsiinfo structure . 
sd: SCSI disk controlle: 
sdiff: side-by-side difference... 
search a file for a character string.. 
search a file for a pattern.. 
search a file for a pattern using. 
search a sorted table........ssssssee 
search and print process accounting files... 
search and update... 
search Interpreter criteria for 
search tables. 


-bsearch(3C) 
acctcom(1) 
..lsearch(3C) 
athconv(1F) 
-hsearch(3C) 
.tsearch(3C) 


section header for a common object file. 
section header of a common object/ 
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/seek to line number entries of a 
/seek to relocation entries of a 
Adnsseek: seek to an indexednamed 
ditsectbl: refresh 

task: global 

tasktbl: create 


/nrand48, mrand48, jrand48, srand48, 
acommon object/ ldsseek, ldnsseek: 
section of a/ ldlseek, Idnleeek: 

ldrseek, ldnrseek: 

a common object file Idohseek: 
object file ldtbseek: 
/opendir, readdir, telldir, 

sweepoff: enable/disable patrol 
shmget: get shared memory 

brk, sbrk: change private data 

shbrk, shsbrk: change shared data 
brk, sbrk: change data 
comm: 

greek: 

addformopt: add a form/ 
semctl: 

semop: 

ipcrm: remove a message queue, 
semget: get set of 


sorted files 


t_sndudata: 


connection 
mail, rmail: 

t_snddis: 

lp, cancel: 

receive data or expedited data 

intro: introduction to 

dis386: disassemble 

SSM: System 

setsid: create 

ascii: map of ASCII character 

alarm: 

umask: 

stty, gtty: 

set, unset: 

sigstack: 

timezone: 
backup.info: backup 
setdtablesize: 

env: 


in core or in files 
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: send a message on a stream 
: send a signal to a process or a group of processes... 
: send completion message. 
; send data or expedited data over a 


section of a common object file..... 
section of a common object file. 


section of a common object file. Idsseek(3X) 
security table.... ditsectbl(1M) 
BECUTItY table......sccssccssesseeeseseseeseseeececnescstsesesseneseneess task(4) 
security table in shared memory. tasktbl(1M) 
SEO! Stream CUILON esesescccaicsssasssssesscaeccceseinesssssiassiciccaaeaees sed(1) 
seed48, lcong48: generate uniformly/, drand48(3C) 
seek to an indexednamed section o} Idsseek(3X) 
seek to line number entries of a... diseek(3X) 
seek to relocation entries of a section of drseek(3X) 
seek to the optional file header of.......... ldohseek(3X) 
seek to the symbol table of a common. Idtbseek(3X) 
seekdir, rewinddir, closedir/. directory(3X) 
seeks on DCC disks sweepon(1M) 
segment identifier .shmget(2) 
segment size...... -brk(3PPS) 
segment size... shbrk(3PPS) 


segment space allocation.. 
select or reject lines common to tw 
select terminal filter.....ssssseecseee 
SELECT window option to a menu.. 


«.-greek(1) 
.addformopt(1M) 


semaphore control operations. ..8emcetl(2) 
semaphore operations.......... ete ..8emop(2) 
semaphore set, or shared memory ID iperm(1) 


semaphores.. semget(2) 
semct]: semaphore control operation: ..8emctl(2) 
semget: get set of semaphores... .semget(2) 


semop: semaphore operations. 
send a data unit... 


..semop(2) 
_sndudata(3N) 
sserseeee PULMS(2) 
Kill(2) 
..tfnotify(1M) 


send mail to users or read mail.........00+. 
send user-initiated disconnect request .. 
send/cancel requests to the LP print service. 
sent over a connection... 

Sequent system calls. 
Series 386 instructions. 
Services Module............ 
session and set process group ID 
set... 
set a process alarm clock.. 
set and get file creation mask.. 
set and get terminal state (defunct).. 
set and unset environment variables.. 
set and/or get signal stack context. 
set default system time zone.. 
set definitions...........00 -backup_info(4) 
set descriptor table size etdtablesize(2SEQ) 
set environment for command execution... env(1) 


sigstack(2SEQ) 
..timezone(4) 
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utime: 

umask: 

tesetpgrp: 

setgroups: 

cpset: copy file and 

m_set_procs: 

semget: get 

remove a message queue, semaphore 
lpusers: 

setpgrp: 

setsid: create session and 

setlocale: 

tabs: 

tegetattr, tcsetattr: get/ 

line discipline getty: 
line discipline uugetty: 
date: print and 

stty: 

stime: 

environment variables in core or in/ 
setuid, setgid: 

ulimit: get and 

a stream 

/toascci, _tolower, _toupper, 


size 
setuid, 
getgrent, getgrgid, getgrnam, 


crypt, 


/endmntent, getmntent, hasmntopt, 
process group 


getpwent, getpwuid, getpwnam, 
process group ID 

getspent, getspnam, 

profile: 

gettydefs: speed and terminal 
IDs 

user 

/getutid, getutline, pututline, 
setbuf, 

machine-independent fashion sputl, 
standard/restricted command/ 
Agetspent, Ickpwdf, ulckpwdf: get 
putspent: write 


pwconv: installs and updates /etc/ 
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set file access and modification timeS.........s.sssssesse utime(2) 
set file-creation mode mask umask(1) 


set foreground process group ID. tesetpgrp(2) 
set group access list .........:100 setgroups(2SEQ) 
set mode, user, and group IDs. .cpset(1) 


set number of child processes. 
set of semaphores......... ase 
set, or shared memory ID. 
set printing queue prioritie: 
set process group ID.... 
set process group ID.... 
set programs location 
set tabs on a terminal 
set terminal state...... 
set terminal type, modes, speed, and... 
set terminal type, modes, speed, and.. 
Bet the date ...sesccsesssseeseeeeeserers 
set the options for a terminal 
set time... 
set, unset: set and unset.. 
set user and group IDs..... 
set user limits ve 


‘iperm(1) 
.lpusers(1M) 


setbuf, setvbuf: assign buffering to.. sssoreseeee8@tbUM(3S) 
setchrclass: character handling... ..ctype(3C) 
setcolor: redefine or create a color .setcolor(1F) 
setdtablesize: set descriptor table setdtablesize(2SEQ) 
setgid: set user and group IDa........ setuid(2) 
setgrent, endgrent, fgetgrent: get group/ getgrent(3C) 
setgroups: set group Access list......sesecseees setgroups(2SEQ) 
setjmp, longjmp: non-local Goto ....s.sessssseeeeserererere setjmp(3C) 


setkey, encrypt: generate hashing encryption......crypt(3C) 
setlocale: set programs location... 
setmnt: establish mount table 
setmntent: get file systen/..... 
setpgid: manipulate signal sets 
setpgrp: run command in its own. 


.setmnt(1M) 
.getmntent(3SEQ) 
.--Betpgid(2) 


setpgrp: set process group ID. 

setpwent, endpwent, fgetpwent: get/. ..getpwent(3C) 
setsid: create session and S€t.......sesssssssesneeesseeeeeeereres setsid(2) 
setspent, endspent, fgetspent, Ickpwadf/. getspent(3X) 
setting up an environment at login time profile(4) 
settings used by getty....cccscscerssaes ttydefs(4) 
setuid, setgid: set user and group. ...setuid(2) 
setup: initialize system for first .-8etup(1) 
setutent, endutent, utmpname,.... ..getut(3C) 
setvbuf: assign buffering to a stream.. setbuf(3S) 
sgetl: access long integer data in a... ..Bputl(3X) 


ibs, PSEA SEVOU, Rn sec cucznnscsssnnsssinesssossuresncanveanssinsensonishnnessess sh(1) 
shadow password file entry getspent(3X) 
shadow password file entry.... putspent(3X) 
shadow: restricted password fil ....Bhadow(4) 
shadow with information frond...... pweonv(1M) 
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shbrk, shsbrk: change 

tasktbl: create security table in 
shmalloc, shrealloc, shfree: 

shmctl: 

@ message queue, semaphore set, or 
shmop, shmat, shmdt: 

shmget: get 

segment size 

shell: run a command using 

assign menu system as user login 


/shutacct, startup, turnacct: 


shells: 
command programming/ sh, rsh: 


shmalloc, shrealloc, 
memory allocator 
shmop, 

operations 

shmop, shmat, 
identifier 
operations 

the machine 
shmalloc, 

shbrk, 

shutdown: 
/nulladm, pretmp, prdaily, prtacct, 
re: reboot and 
shutdown: system 
system state 
information file 
actions 

sigemptyset, sigfillset, 


allocator 


manipulate/ 


sigemptyset, sigfillset, sigaddset, 
sigdelset, sigismember: manipulate/ 
sigismember/ sigemptyset, 
sigpause: signal management sigset, 
sigset, sighold, sigrelse, 

/sigfillset, sigaddset, sigdelset, 
sigsetjmp, 

login: 

pause: suspend process until 

specify what to do upon receipt of a 
sigsuspend: wait for a 

sigaction: examine and change 
sigcontext: get 

sigrelse, sigignore, sigpause: 

setpgid: manipulate 

sigdelset, sigismember: manipulate 
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shared data segment SiZC .....ssesssssssesesssseeneeseees shbrk(3PPS) 
shared MeEMOTY......s0eese0 tasktbl(1M) 
shared memory allocator .. 


shared memory control operations. 
shared MeMOTY ID.....s.sseeee 
shared memory operations.. 
shared memory segment identifier 
shbrk, shsbrk: change shared data “shbrk(3PPS) 

gestae shell(1F) 
..tf{menush(1M) 
shell command.. system(3S) 
shell (command interpreter) with C-like syntax........ esh(1) 
shell procedures for accounting 
shell: run a command using shel 
Shell table.........sscssecsserssesseees 
shell, the standard/restricted.. 
shells: shell table........e0e 
shfree: shared memory allocator. 
shmalloc, shrealloc, shfree: shared 
shmat, shmdt: shared memory operations... 
shmct]: shared memory control...... 
shmdt: shared memory operations 
shmget: get shared memory segment....... 
shmop, shmat, shmdt: shared memory.. 
showcfg: show the configuration of. 
shrealloc, shfree: shared memory.... 
shsbrk: change shared data segment size 
shut down system, change system state 
shutacct, startup, turnacct: shell/... 


-shells(4) 
.8h(1) 
.shells(4) 


.shbrk(3PPS) 
.shutdown(1M) 
acctsh(1M) 


shutdown command SCripts....s.sssssesssersesscesssssenesseennessesoes re(4) 
shutdown information file......... .shutdown(4) 
shytdown: shut down system, change .shutdown(1M) 
shutdown: system shutdown.....ssee .-shutdown(4) 
sigaction: examine and change signal .. .. Sigaction(2) 
sigaddset, sigdelset, sigismember...... .sigemptyset(2) 
sigcontext: get signal context sigcontext(2SEQ) 
sigdelset, sigismember: manipulate/. .sigemptyset(2) 
sigemptyset, sigfillset, sigaddset, .sigemptyset(2) 
sigfillset, sigaddset, sigdelsct, . .sigemptyset(2) 
sighold, sigrelse, sigignore, sigset(2) 
sigignore, sigpause: signal... sigsct(2) 
sigismember: manipulate signal sets .sigemptyset(2) 
siglongjmp: non-local jumps. ..sigsetjmp(3C) 
BIQM OD sscscesssserssscscsesereccccoressssssosecessucssecsesssesacavancororeneers login(1) 


signal context... 
signal management 
signal sets. 


signal sets. sigemptyset(2) 
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receipt of a signal 

sigstack: set and/or get 

kill: send a 

sigpending: examine pending 
examine and change blocked 
ssignal, gsignal: software 
sighold, sigrelse, sigignore, 


blocked signals 

signal management sigset, sighold, 
sigignore, sigpause: signal/ 

jumps 

stack context 


atan2: trigonometric/ trig: 
m_single, m_multi: mark 

functions 

initialize barrier, wait at barrier 
s_unlock: initialize, lock, unlock/ 
sbrk: change private data segment 
getdtablesize: get descriptor table 
getpagesize: get system page 
setdtablesize: set descriptor table 
shsbrk: change shared data segment 
of object files 

interval 

interval 

s_init_lock, 

ttyslot: find the 

consmem, 

ssignal, gsignal: 

qsort: quicker 

tsort: topological 

sort: 


select or reject lines common to two 
bsearch: binary search a 
an object file list: produce C 


open file into the processs address 
unmap part of the processs address 
into processs virtual] address 
brk, sbrk: change data segment 
ct: 
vfork: 
fepec: format 
signal: 
getty: set terminal type, modes, 
uugetty: set terminal type, modes, 
gettydefs: 
find spelling errors 

fil 


memory efficient way 
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le spellhist: unmatched spelling words... 


Permuted Index 


signal: specify what to do upon. 
signal stack context.... 
signal to a process or a group of processe 
signals.... 
signals.. 
signals. 
sigpause: signal management............ 
sigpending: examine pending signals 
sigprocmask: examine and change. 
sigrelse, sigignore, sigpause: 
sigset, sighold, sigrelse,... 
sigsetjmp, siglongjmp: non-local. 
sigstack: set anW/or get signal.. 
sigsuspend: wait for a signal 


igsetjmp(3C) 
igstack(2SEQ) 
..8igsuspend(2) 


sin, cos, tan, asin, acos, atan,. trig(3M) 
single-process code section. ..m_single(3PPS) 
sinh, cosh, tanh: hyperbolic ......sscssssssssesseseseersesessees sinh(3M) 


s_init_barrier, s_wait_barrier: 
s_init_lock, s_lock, s_clock, 


“getdtablesize(2SEQ) 
getpagesize(2SEQ) 
-setdtablesize(2SEQ) 


soaatocaastewd shbrk(3PPS) 
.see C and Lang Tools Binder 
sleep: suspend execution for an ..«8leep(1) 


sleep: suspend execution for.. .-sleep(3C) 
s_lock, s_clock, s_unlock: initiali _lock(3PPS) 
slot in the utmp file of the current user. -.ttyslot(3C) 
sm, 88: console memory drivers. .consmem(7) 
software Signals .......ssscsesees i ..88ignal(3C) 
sort eee 


sort and/or merge files 
sort: sort and/or merge files... 
sorted files... 
“bsearch(3C) 


source listing ‘from see C and Lang Tools Binder 


BP: STREAMS pipe device.....secsssessssessesesessensnceesonesseneeorees sp(7) 
space... mmap(2SEQ) 
space -munmap(2SEQ) 
space... pmap(7) 
space allocation. brk(2) 


ct(1C) 
-vfork(2) 


spawn getty to a remote terminal. 
spawn new process in a virtual 


specification in text files........... .fspec(4) 
specify what to do upon receipt of a signal signal(2) 
speed, and line discipline... .getty(1M) 
speed, and line discipline... uugetty(1M) 
speed and terminal settings used by getty. eer 


spell, hashmake, spellin, hashcheck-:.. 
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spell, hashmake, 

hashmake, spellin, hashcheck: find 
: spellhist: unmatched 
cesplit: context 

split: 

faplit: 


uucleanup: uucp 

printf, fprintf, 

data in a machine-independent/ 
square root/ exp, log, log10, pow, 
sqrt: exponential, logarithm, power, 
rand, 

frand48, nrand48, mrand48, jrand48, 
consmem, sm, 

scanf, facanf, 


wp: 
wd: 


terminal multiplexor driver 
sigstack: set anW/or get signal 

copy: perform a 

prtvtoc: print the VTOC of a 
dual-channel disk/ zdformat: 
CCSformat: 

dump: 

operating system boot: run a 
intro: introduction to system 
stdio: 

stdipe: ftok: 

sh, rsh: shell, the 

operating system for beginning/ 
Ipsched, Ipshut, Ipmove: 

/pretmp, prdaily, prtacct, shutacct, 
call 


package 


stat: data returned by 
information 

ustat: get filesystem 

ff: list filenames and 

fastat: report filesystem 
communication facilities 
ps: report process 

stat, Istat, fatat: get file 
feof, clearerr, fileno: stream 
uustat: uucp 

Ipstat: print information about the 
* input/output package 
communication package 


waitpid: wait for a child process to 
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spellin, hashcheck: find spelling errors 
spelling errors.. 


split a file into pieces. 
split {77, ratfor, or efi files 
split: split a file into pieces... 
spool directory clean-up........ 
sprintf: print formatted output 
sputl, sgetl: access long integer... 
sqrt: exponential, logarithm, power,.. 
square root FUNCTIONS ......ccsssseeereeeeeee 
srand: simple random-number generator 
srand48, seed48, lcong48: generate/... 
ss: console memory drivers... 
sscanf: convert formatted input.. 
ssignal, gsignal: software signals. 
SSM parallel line printer interface 
SSM SCSI disk controller... 
SSM: System Services Module 
st: Systech MTI-800/1600/165 
Btack CONLEXt ..ssecsscrsseeeeeeeen 

standalone data transfe 
standalone disk device...... 
standalone disk formatter fo 
standalone embedded SCSI disk formatter. 
standalone memory dump .......s+00« COT 
standalone program or bring up the. 


.drand48(3C) 
..consmem(7) 


standalone utilities........ ee 

standard buffered input/output package... 

standard interprocess communication .stdipe(3C) 
standard/restricted command programming/. .8h(1) 


starter: information about the ....s.ssseoe 
start/stop the LP print service and move/ 
startup, turnacct: shell procedurev/... 
stat: data returned by stat system.. 
stat, Istat, fatat: get file status.. 
stat system Call .........sssecereere: 
statfs, fstatfs: get filesystem 
statistics... 


.statfs(2) 
ustat(2) 
(1M) 
.fsstat(1M) 


status inquiries. 
status inquiry and job control. 
status of the LP print service 
stdio: standard buffered... 
stdipe: ftok: standard interprocess.. 
stime: set time...... 
stop or terminate 
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Ipsched, Ipshut, Ipmove: start/ 
rc0: run commands performed to 
icheck: filesystem 


strncmp, strepy, strncpy,/ string: 
/strncmp, strepy, strocpy, strlen, 
cleanup program 

string: streat, strdup, strncat, 
/strdup, strncat, strcmp, strncmp, 
/strchr, strrehr, strpbrk, strspn, 
strepy, strncpy,/ string: streat, 
fclose, flush: close or flush a 

fopen, freopen, fdopen: open a 
reposition a file pointer ina 

getw: get character or word from a 
getmsg: get next message off a 

gets, fgets: get a string from a 

putw: put character or word on a 
putmag: send a message on a 

puts, fputs: put a string on a 

setvbuf: assign buffering to a 

push character back into input 

sed: 

ferror, feof, clearerr, fileno: 


driver 

clone: open any minor device on a 
strclean: 

strerr: 

log: interface to 

poll: 

streamio: 

Transport Interface cooperating 
Interface read/write interface 
sp: 

streampty: 

strace: print 

streamtty: Generic 

1d0: 

driver interface 


long integer and base-64 ASCII 
tzset: convert date and time to 
convert floating-point number to 
fgrep: search a file for a character 
regex: match patterns against a 
gps: graphical primitive 

gets, fgets: get a 

puts, fputs: put a 

echo: put 

strpbrk, strspn, strespn, strtok: 
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stop the LP print service and move/,, 
stop the operating system.... 
storage consistency check... 
strace: print STREAMS trace message: 
streat, strdup, strncat, stremp....... 
strehr, strrehr, strpbrk, strspn/ 
strclean: STREAMS error logger 
strcmp, strncmp, strepy, strncpy,/. 
strepy, strncpy, strlen, strchr/.. 
strespn, strtok: string operations. 
strdup, strncat, strcmp, strncmp,. 


leet 


.string(3C) 
.string(3C) 
.string(3C) 
.string(3C) 
..fclose(3S) 
..fopen(3S) 
seek(3S) 
.gete(3S) 
.getmsg(2) 
....gets(3S) 
«sone pute(3S) 
.putmsg(2) 
... puts(3S) 
setbuf{(3S) 


stream eittor. ...9ed(1) 
stream status inquiries. “ferror(3S) 
streamio: STREAMS ioct] commands. .8treamio(7) 
streampty: STREAMS pseudo terminal streampty(7) 
STREAMS iver .....scssssssssssesnssssecsenseeeees clone(7) 
STREAMS error logger cleanup program. strclean(1M) 
STREAMS error logger daemon.. strerr(1M) 
STREAMS error logging and event tracing....sssssse log(7) 
STREAMS input/output multiplexing. .-poll(2) 
STREAMS ioct] commands... “streamio(7) 
STREAMS module.... ..timod(7) 
STREAMS module... ..tirdwr(7) 
STREAMS pipe device.......scssssssssssesssseseceeneeserneenessencenseens sp(7) 
STREAMS pseudo terminal driver.. streampty(7) 
STREAMS trace messages........ strace(1M) 
STREAMS tty driver interface. streamtty(7) 
STREAMS tty line discipline .......s.sscsscssssscessessseneensenseeeee 1d0(7) 
streamtty: Generic STREAMS tty ... streamtty(7) 
strerr: STREAMS error logger daemon strerr(1M) 


strftime: format time information. 


string, format of graphical files. 
string from a stream. 
string on a stream...... 
string on virtual output 
string operations. 
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stremp, strocmp, strepy, strocpy,/ 
strtod, atof: convert 

strtol, atol, atoi: convert 

cftime: language specific 

object file 

/stremp, strncmp, strepy, strncpy, 
string: streat, strdup, 

/strcat, strdup, strncat, stremp, 
/strncat, strcmp, strncmp, strepy, 
/strncpy, strlen, strchr, strrehr, 
/strepy, strncpy, strlen, strchr, 
/strlen, strchr, strrchr, strpbrk, 
character 

double-precision number 

strrehr, strpbrk, strspn, strespn, 
to integer 

processes using a file or file 
getscsimatch: get scsiinfo 
getzdinfobyname: get zdinfo 
read constab entries into a 
t_alloc: allocate a library 

t_free: free a library 

state (defunct) 


backup.codes1: backup 

m_fork: execute a 

dbm_clearerr, dmb_blkflush: database 
plot: graphics interface 

sulog: log of 


of a file 

du: 

repquota: 

acctcms: command 
s_init_lock, s_lock, s_clock, 
sync: update the 

sync: update 

su: become 

getgroups: get 

uuep: networking 

Iptypes: table of printer types 
m_park_procs, m_rele_procs: 
sleep: 

sleep: 

pause: 


records 


s_init_barrier, 
swap: 
swab: 


wait at barrier 


/a command with priority aging, PFF, 
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string: streat, strdup, strncat, 
string to double-precision number 
string to integer... 


strncat, stremp, strncmp, strcpy, strnepy/... 
strncmp, strepy, strncpy, strlen/. 
strncpy, strlen, strehr, strrchr//... 
strpbrk, strspn, strespn, strtok//. 
strrchr, strpbrk, strspn, strcspn, 
strspn, strespn, strtok: string/ 
strstr: find first occurrence of... 
strtod, atof: convert string to... 
strtok: string operations... 
strtol, atol, atoi: convert string.. 


getzdinfo(3SEQ) 
read_constab(3SEQ) 
.t_alloc(3N) 
structure... wen 
stty, gtty: set and get termina 
stty: set the options for a terminal... 
su: become superuser or another user... 
subcode definitions. 
subprogram in parallel. 
subroutines... 
subroutines... 
substitute user events... 
sulog: log of substitute user events. 
sum: print checksum and block count... 
summarize disk usage 
summarize quotas for a filesystem 
summary from per-process accounting 
s_unlock: initialize, lock, unlock locks. 


“s_lock(3PPS) 


superblock .synce(1M) 
superblock.... sync(2) 
superuser or another user +«5u(1M) 
supplementary group IDs. ..getgroups(2) 


support files.. .uucp(4) 
supported by the menu system.. 
suspend and resume child procesy/.....m_park_| ae eer 
suspend execution for an interval. 
suspend execution for interval... 
suspend process until signal 
swab: SWAP bYtEB.....cseeeseeene 
8_wait_barrier: initialize barrier,.. 
swap administrative interface... 


swap: swap administrative interface 
swapping, or processor migration/ 
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© seeks on DCC disks sweepon, 


patrol seeks on DCC disks 

symbol table/ ldgetname: retrieve 
symbol name for common object file 
ldtbindex: compute the index of a 
ldtbread: read an indexed 

syms: common object file 

_ldtbseek: seek to the 

unistd: file header for 

readlink: read value of a 

symlink: make 

of common operating system terms and 
file 

table format 


controlling FMLI object vsig: 


check documents for correct eqn 
(command interpreter) with C-like 
administration 


variables 
configuration file 


perror, errno, 
& menu system functions 
perror, errno, sys_errlist, 
multiplexor driver st: 
Ip: 

bsearch: binary search a sorted 
constab: constructed devices 

devtab: virtual device 

ditsectbl: refresh security 

kernel auto-configuration device 
fstab: file-system- 

muttab: mounted filesystem 

setmnt: establish mount 

shells: shell 

task: global security 

name for common object file symbol 
/compute the index of a symbol 
ldtbread: read an indexed symbol 
syms: common object file symbol 
tasktbl: create security 

get maximum in-use descriptor 
ldtbseek: seek to the symbol 

the menu system Iptypes: 
getdtablesize: get descriptor 
setdtablesize: set descriptor 


classification and conversion 
hdestroy: manage hash search 
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sweepoff: enable/disable patrol 
sweepon, sweepoff: enable/disable.. 
symbol name for common object file............. “ldgetname(3X) 
symbol table entry.....sssssascecsseees ldgetname(3X) 
symbol table entry of a common/ <a 


symbol table format... 

symbol table of a common object file.. idtbseek(3X) 
Symbolic CONStaNts......scsssesscscsssecessssescecarencecerereeeeceeer unistd(4) 
symbolic link........ -readlink(2SEQ) 
symbolic link to a file. symlink(2SEQ) 
BY MD 8 sisassscssncasosiscasssnsasessavoassescssceavevsssasscscaisessays glossary(1) 
symlink: make symbolic link to a symlink(2SEQ) 


syms: common object file symbol. 
sync: update superblock. 
sync: update the superbloc! 


synchronize a co-process with the vsig(1F) 

: synchronize transport library... t_syne(3N) 
syntax checkeq(1) 
syntax. .c8h(1) 
sysadm: menu interface to do system. sysadm(1) 
syscall: indirect system call......... -syscall(2) 
sysconf: get configurable system.. 


sys_config: format of a system. 
sys_errlist, sys_nerr: system error messages. 
sysi86: machine specific functions. 
syskeymap: identify keys to internal. 
sy8_nerr: system error messages........ 
Systech MTI-800/1600/1650 terminal. 
Systech parallel line printer interface 
table. 


“ayskeymap(4) 
perror(3C) 
+ 8t(7) 


.-1p(7) 
-bsearch(3C) 
constab(4) 
.devtab(4) 
..dltsectbl(1M) 
dumpconf(1M) 


table .fstab(4) 
table. muttab(4) 
table. -setmnt(1M) 
table 

table 

table en 


TY. 
table entry of a common object file. 
table entry of a common object file.. 
table format... 
table in shared memory. 
table index ......ccsesesoeee 
table of a common object file.. 
table of printer types supported by. 
table size.... 


....lptypes(4) 
.getdtablesize(2SEQ) 
.setdtablesize(2SEQ) 
...¢hrtbl(1M) 
-hsearch(3C) 
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tabs: set 


ctags: create a 

file 

structure 

trig: sin, cos, 

sinh, cosh, 

tm: SCSI 

ts: SCSI 

hpio: Hewlett-Packard 2645A terminal 
tar: 

mtio: UNIX magnetic 

tg: SCSI 1/2-inch magnetic 

xt: Xylogics 472 MULITBUS magnetic 
mt: magnetic 


shared memory 
transport endpoint 
deroff: remove nroff, 
terminal state 
group ID 


with another transport user 
tcgetattr, 

group ID 

tsearch, tfind, 


4014: paginator for the 

init, 

directory: opendir, readdir, 

temporary file tmpnam, 
tmpfile: create a 

tmpnam, tempnam: create a name for a 
terminals 

term: format of compiled 


captoinfo: convert a 
base 

paginator for the Tektronix 4014 
special functions of the DAS] 450 
ct: spawn getty to a remote 
ctermid: generate filename for 
hangup the specified controlling 
stty: set the options for a 

tabs: set tabs on a 

tty: get the name of the 

ttyname, isatty: find name of a 
/associated with a terminal or the 
termcap: 
terminfo: 


description 
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tabs on a terminal.... 
tabs: set tabs on a termina 
t_accept: accept a connect request... 


Geni files: scsceresscessstecasssspecseeseess tags(1) 
tail: deliver the last part of a .tail(1) 
t_alloc: allocate a library...... t_alloc(3N) 


tan, asin, acos, atan, atan2: trigonometric/ 
tanh: hyperbolic functions 
tape controller..... 
tape controller. 
tape file archiver 
tape file archiver 
tape interface. 
tape interface.. 
tape interface... 
tape manipulating program. 
tar: tape file archiver... 
task: global security table.. 
tasktbl: create security table in.. 
t_bind: bind an address to a.. 
tbl, and eqn constructs.... 
tegetattr, tcsetattr: get/set. 
tegetpgrp: get foreground process... 
t_close: close a transport endpoint.. 
t_connect: establish a connection 
tesetattr: get/set terminal state 
tesetpgrp: set foreground process 
tdelete, twalk: manage binary search trees 
tee: pipe fitting.......ssrersressseee seaaaces seteenevenanee 
Tektronix 4014 terminal 
telinit: process control initialization.. 
telldir, seekdir, rewinddir/...... 
tempnam: create a name fora. 
temporary file. 
temporary file. 
term: conventional names for 


aif, connect(3N) 
tegetattr(2) 
..tesetpgrp(2) 


eee 
.tmpnam(3S) 
.tmpfile(3S) 
.tmpnam(3S) 


term: format of compiled term file . 
termcap description into a terminfo. 
termcap: terminal capability data. 
termina]... 


terminal. 450(1) 
terminal ct(1C) 
terminal 

terminal “fvhangup(2SEQ) 


terminal .stty(1) 
terminal. tabs(1) 
terminal ..-tty(1) 


.ttyname(3C) 
terminal associated with a device .ttydevname(1) 
terminal capability data base... 


terminal capability database... 
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2) streampty: STREAMS pseudo 


greek: select 

tty: controlling 

termio: general 

dial: establish an out-going 

st: Systech MTI-800/1600/1650 

xs: Xylogics 781 

tput: initialize a 

/get the device associated with a 
optimization package curses: 
gettydefs: speed and 

tegetattr, tcsetattr: get/set 

stty, gtty: set and get 

hpio: Hewlett-Packard 2645A 

line discipline getty: set 
line discipline uugetty: set 
functions of DASI 300 and 3008 
getpseudotty: get pseudo 

special functions of Hewlett-Packard 
term: conventional names for 

wait for a child process to stop or 
kill: 

exit, _exit: 

tic: 

tput: initialize a terminal or query 
a convert a termcap description into a 
infocmp: compare or print out 
database 


of common operating system 


isnan: isnand, isnanf: 

ed, red: 

ex: 

edit: 

errormsg: error message 

newform: change the format of a 
fspec: format specification in 
isismgr: ISIS file manager, updates 
plock: lock process, 

search trees tsearch, 
reporter 

login shell 


interface 
service information 


merge: 


& batch: execute commands at a later 
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terminal driver. 
terminal filter... 
terminal (gentty) interface... 
terminal interface.......... 
terminal line connection... 
terminal multiplexor driver. 
terminal multiplexor driver... 
terminal or query terminfo database 
terminal or the terminal associated/... 
terminal screen handling and... 
terminal settings used by getty.. 


..8treampty(7) 
" as 1) 


terminal state (defunct). 
terminal tape file archive 
terminal type, modes, speed, and... 
terminal type, modes, speed, and.. 
terminals... 
terminals 
terminala.... 
terminals... 
terminate... 
terminate a process 
terminate process. 
terminfo compiler 
terminfo database.. 
terminfo description. 
terminfo descriptions... 
terminfo: terminal capability. 


..infocmp(1M) 
.terminfo(4) 


termio: general terminal interface. .termio(7) 
terms and symbols. ..glossary(1) 
t_error: produce error message... ‘t _error(3N) 


test: condition evaluation command 
test for floating-point Nal/........s00 isnan(3C) 
text editor.. 
text editor.. 
text editor (variant of ex for casual users). eo 
text file errormsg(4) 
:newform(1) 


text files. ..-fspec(4) 
text files in ISIS file format.. isismgr({1M) 
text, or data in MeMOTY........0 + plock(2) 
tfind, tdelete, twalk: manage binary. tsearch(3C) 
tfipe: interprocess COMMUNICALION .......csseeeeeerensees tfipe(1M) 
tfmenush: assign menu system as user tfmenush(1M) 


tfnotify: send completion message. 
t_free: free a library structure... 
tg: SCSI 1/2-inch magnetic tape. 
t_getinfo: get protocol-specific..... 


t_getstate: get the current state t_getstate(3N) 
three-way file merge... ee 
tic: terminfo compiler. .tic( 1M) 


LIMNE.....scncessescrsseorenseenee 
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view a file one full screen at a 
setting up an environment at login 
stime: set 

time: get 

time, ptime: 

and system activity timex: 
acctcon1, acctcon2: connect- 


strftime: format 
profil: execution 


mnktime, tzset: convert date and 
clock: report CPU 

timezone: set default system 

times: get process and child process 
set file access and modification 
times 

update access and modification 
process data and system activity 
zone 

cooperating STREAMS module 
read/write interface STREAMS module 
request 

a transport endpoint 


processor 


temporary file 

Aisgraph, isascii, tolower, toupper, 
/tolower, _toupper, _tolower, 

conv: toupper, tolower, _toupper, 
Aisascii, tolower, toupper, toascci, 
Aspunct, isprint, isgraph, isascii, 
conv: toupper, 

endpoint 

tsort: 

transport endpoint 

acctmerg: merge or add 
modification times of a file 
/tolower, toupper, toascci, _tolower, 
/isprint, isgraph, isascii, tolower, 
conv: toupper, tolower, 

_tolower, toascii: translate/ conv: 
terminfo database 


ptrace, mptrace: process 

strace: print STREAMS 

to STREAMS error logging and event 
copy: perform a standalone data 
init.d: system level 

_toupper, _tolower, toascii: 
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time 
time a command 


time a command; report process data .timex(1) 
time accounting. ..acctcon(1M) 
Gimmes Pet itl me be scecesecssevasevessesesvarsscusosoreesesssevcecwavenesvesed time(2) 


time information 
time profile 
time, ptime: time a command... 
time to string... 
time used... 


.strftime(3C) 


..ctime(3C) 
.-clock(3C) 
..timezone(4) 
times... .times(2) 
utime(2) 
.times(2) 
.touch(1) 
.timex(1) 
..timezone(4) 


times: get process and c| 
times Of 8 file wc... ssscsssssseseseseseesees 
timex: time a command; report 
timezone: set default system time. 
timod: Transport Interface... 


tirdwr: Transport Interface tirdwr(7) 
t_listen: listen for a connect... _listen(3N) 
t_look: look at the current event on .t_look(3N) 


tm: SCSI tape controller......... aaeeaa 
tmp_affinity: bind a process to a... 
tmp_ctl: multi-processor control.. 
tmpfile: create a temporary file... 
tmpnam, tempnam: create a name fora 
toascci, tolower, _toupper/...escsoseseereere 
toascii: translate characters .. 
_tolower, toascii: translate/... 
_tolower, _toupper, setchrclassz 
tolower, toupper, toascci, _tolower,. 
tolower, _toupper, _tolower, toascii: transla 
t_open: establish a transport 


mp_affinity(2SEQ) 
..tmp_ctl(2SEQ) 
..tmpfile(3S) 
.tmpnam(3S) 


topological SOrt.......srssesseeeeee 
t_optmgmt: manage options for a t_optmgmt(3N) 
total accounting files........ : ..acctmerg( 1M) 


touch: update access ANG......secssesesreseesesnenssseeesssetsaners touch(1) 


_toupper, setchrelass: character/. .ctype(3C) 
toupper, toascci,_tolower/ ctype(3C) 
_toupper, _tolower, toascii: translate/. conv(3C) 
toupper, tolower, _toUPpeT, «ss conv(3C) 
tput: initialize a terminal or query tput(1) 
tr: translate characters aeett(1) 
trace facility... ptrace(2) 
trace messages strace(1M) 
tracing... log(7) 
transfer .. copy(8) 
transition files directory. nit.d(4) 
translate characters.....ec--sssssr conv(3C) 
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tr: 

t_bind: bind an address to a 

t_close: close a 

look at the current event on a 
t_open: establish a 

t_optmgmt: manage options for a 
t_unbind: disable a 

STREAMS module timod: 
interface STREAMS module _ tirdwr: 
t_sync: synchronize 

the scheduler for the uucp file 
uucico: file 

establish a connection with another 
data sent over a connection 
confirmation from a connect request 
disconnect 

orderly release indication 


error indication 

ftw: walk a file 

tdelete, twalk: manage binary search 
atan, atan2: trigonometric/ 

cos, tan, asin, acos, atan, atan2: 


truncate, ftruncate: 

to a specified length 

u8b2, u3b5, vax: get processor type 
true, false: provide 


manage binary search trees 
over a connection 
disconnect request 

release 


library 
interface 
streamtty: Generic STREAMS 


1d0: STREAMS 

between major/minor numbers and 
associated with a terminal or the/ 
terminal 
dev_to_ttyname, 

file of the current user 
endpoint 

vintune: 

tunefs: 

filesystem 

examine and change virtual memory 
/prdaily, prtacct, shutacct, startup, 
tsearch, tfind, tdelete, 


major/minor/ 


parameters 
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translate characters... 
transport endpoint... 
transport endpoint. 
transport endpoint. 
transport endpoint. 
transport endpoint.. 
transport endpoint. 
Transport Interface cooperating 
Transport Interface read/write... 
transport library... 
transport program.. 
transport program for the uucp system.. 


_bind(3N) 
..t_close(3N) 


t, optmgmt(3N) 
t_unbind(3N) 


transport user... ot. connect(3N) 
t_rev: receive data or expedited ......cccssessseesscenee t_rev(3N) 
t_reveonnect: receive the.....ss0 __rcvconnect(3N) 
t_revdis: retrieve information from. t_revdis(3N) 
t_revrel: acknowledge receipt of an... .t_revrel(3N) 
t_revudata: receive a data unit. __rcvudata(3N) 
t_revuderr: receive a unit data.. aie 


trig: sin, cos, tan, asin, acos, 
trigonometric functions... 


true, false: provide truth values soon true(1) 
truncate a file to a specified length... ‘truncate(2SEQ) 
truncate, ftruncate: truncate a file .truncate(2SEQ) 
truth value.... -machid(1) 


truth values... 


ts: SCSI tape controller.....cssscssssseceseeneseseenesenessenessacerencars ts(7) 
tsearch, tfind, tdelete, twalk: .tsearch(3C) 
t_snd: send data or expedited dat. .t_snd(3N) 
t_snddis: send user-initiated... __snddis(3N) 
t_sndrel: initiate an orderly... t_sndrel(3N) 
t_sndudata: send a data unit. t_sndudata(3N) 
teort: topological SOrt .....ssssssssessessseneeserseeeassesoeneseoe tsort(1) 
t_sync: synchronize transport. t_syne(3N) 


tty: controlling terminal (gentty). tty(7) 
tty driver interface ........secsssesees streamtty(7) 
tty: get the name of the terminal. .tty(1) 
tty line discipline. .1d0(7) 
tty names. dev_to_ttyname(3C) 
ttydevname: get the device. ttydevname(1) 
ttyname, isatty: find name of a. ..ttyname(3C) 
ttyname_to_dev: convert between dev_to_ttyname(3C) 
ttyslot: find the slot in the utmp. ...ttyslot(3C) 
t_unbind: disable a transport... _unbind(3N) 
tune system-wide virtual-memory ....vmtune(1M) 


tune up an existing filesystem... 
tunefs: tune up an existing... 
tuning parameters... 
turnacct: shell procedures for... 
twalk: manage binary search trees.. 


“vm_ctl(2SEQ) 
..acctsh(1M) 
.tsearch(3C) 
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types: primitive system data 
Iptypes: table of printer 

/asctime, cftime, ascftime, mktime, 
machid: i386, ns32000, pdp11, 
machid: i386, ns32000, pdp11, u3b, 
Ai886, 0832000, pdp11, u3b, u3b2, 
/endspent, fgetspent, lckpwdf, 
mask 


mount, 


mountall, 
system 


filesystems 


expand data compress, 
unget: 

SCCS file 

input stream 

file 

mktemp: make a 
constants 
t_rcvudata: receive a data 
t_sndudata: send a data 
t_revuderr: receive a 


mtio: 

cu: call another 

link, unlink: link and 
link, 


m_lock, m_unlock: lock, 

s_clock, s_unlock: initialize, lock, 
space munmap: 
spellhist: 

umount: 

mount, umount: mount and 
mountall, umountall: mount, 

pack, peat, 

set, unset: set and 

variables in core or in files set, 
lsearch, lfind: linear search and 
touch: 

make: maintain, 

bdflush: 

bdflush: 

syne: 

sync: 


fron/ pweonv: installs and 
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types... 
types: primitive system data types.. 
types supported by the menu system. 
tzset: convert date and time tod/........... 
u3b, u3b2, u3b5, vax: get processor type/.. 
u3b2, u3b5, vax: get processor type/.. 
u3b5, vax: get processor type truth/. 
uadmin: administrative control... 
uadmin: administrative control... 
ulckpwdf: get shadow password file entry 
ulimit: get and set user limits sae 

umask: set and get file creation... 
umask: set file-creation mode mas 
umount: mount and unmount filesystems 
umount: unmount a filesystem 
umountall: mount, unmount multip’ 
uname: get name of current operating.. 
uname: print name of current system... 
uncompress, zcat: compress and..... 
undo a previous get of an SCCS file. 
unget: undo a previous get of an. 
ungete: push character back into 


«Iptypes(4) 
..ctime(3C) 
.-machid(1) 
..machid(1) 
..machid(1) 
-uadmin(1M) 
-uadmin(2) 
.getspent(3X) 
ulimit(2) 


-umount(2) 
ountall(1M) 


"compress(1) 
-unget(1) 
-unget(1) 


unig: report repeated lines in A....ssssssssscesseseaessesnssees uniq(1) 
unique filename.......sssesereeee «mktemp(3C) 
unistd: file header for symbolic unistd(4) 


unit data error indication. 
units: conversion program . 
UNIX magnetic tape interface... 


t_revuderr(3N) 
..units(1) 


unlink: link and unlink files and directories 
unlink: remove directory entry 


unlock locks .™, lock(3PPS) 


unlock locks.. s_lock(3PPS) 
unmap part of the processs a .-munmap(2SEQ) 
unmatched spelling words file... .-8pellhist(4) 
unmount a filesystem... -umount(2) 
unmount filesystems. mount(1M) 
unmount multiple filesystems.. mountall(1M) 
unpack: compress and expand files. «.pack(1) 


unset environment variables in core or in files.........set(1F) 
unset: set and unset environment 
update 
update access and modification times of a file 
update, and regenerate groups of programs 
update daemon... 
update daemon... 
update superblock. 
update the superblock 
updates /etc/shadow with information... 
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isismgr: ISIS file manager, 

been up 

du; summarize disk 

quota: display disk 

retrieve a command description and 
description and usage examples 


getusclk, 

get character login name of the 
logname: return login name of 
setup: initialize system for first 

su: become superuser or another 

a connection with another transport 
slot in the utmp file of the current 
write: write to another 

cpset: copy file and set mode, 
setuid, setgid: set 

id: print 

crontab: 

addusr.def: add 

/geteuid, getgid, getegid: get real 
environ: 

run commands performed for multi- 
sulog: log of substitute 

generate disk accounting data by 
ulimit: get and set 

tfmenush: assign menu system as 
menumsg: route 

edquota: edit 

/getegid: get real user, effective 
t_snddis: send 

editor (variant of ex for casual 

the operating system for beginning 
wall: write to all 

ut_delete_user: add/delete 

mail, rmail: send mail to 

login attempts 


add/delete users in utmp file 

utmp file ut_add_user, 
introduction to system standalone 
get_process_stats: get resource 
modification times 

utmp, wtmp: 

ut_delete_user: add/delete users in 
endutent, utmpname, getutpid: access 
ttyslot: find the slot in the 

formats 

/pututline, setutent, endutent, 

and permissions file 

the uucp system 

clean-up 
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updates text files in ISIS file format 
uptime: show how long system has... 
usage 


isismgr(1M) 
...-Uptime(1) 


usage and limits.. quota(1) 
usage examples... usage(1) 
usage: retrieve a command.... usage(1) 
usclk: 32-bit microsecond counter. ..usclk(7) 
usclk_init: get/init microsecond clock.........getusclk(3SEQ) 
USET ssessecscesssenensscsrsesaseceeseesenssnsnsnseress a cuserid(3S) 
user.. 


user... 
user... 
user.. 
user... 
user. 
user, and group IDs. 
user and group IDa..... 
user and group IDs and names... 
user crontab file 
user defaults.......000 Ceey eoeanaes 
user, effective user, real group/. 
user environment... 
user environment 
user events 
user ID.... 
user limits.. 
user login shell......04. aesésesseaceuscainces 
user message to menu message queue 
MBET QUOEAS srésiscassnstsssecnsseaseseeseaseasinece 
user, real group, and effectivel.. «getuid(2) 
user-initiated disconnect request .. _-snddis(3N) 
UWBSOTS) vssiasagiussseesvessveasecsbessvevesiascaviseassssssessadevsusessvisecetaaed edit(1) 
users .starter(1) 
users ... 
users in utmp file 
users or read mail... 
/usr/adm/loginlog: log of failed/.. 
ustat: get filesystem statistics 
ut_add_user, ut_delete_user:.. 
ut_delete_user: add/delete users in.. 
utilities 
utilization information. 
utime: set file access and. 


...edquota(1M) 


intro(8) 
get_process_stats(2SEQ) 


utmp file entry. 
utmp file of the current user. 
utmp, wtmp: utmp and wtmp entry 
utmpname, getutpid: access utmp file/ . 
uucheck: check the uucp directories. uucheck(1M) 
uucico: file transport program for. 
uucleanup: uucp spool directory... 


“yucleanup(1M) 
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uucheck: check the 
uusched: the scheduler for the 


uucleanup: 

uustat: 

file transport program for the 
UNIX-to-UNIX system/ 
speed, and line discipline 
uucp, 

uucp, uulog, 

uuto, 

file transport program 
control 
UNIX-to-UNIX system/ 

with debugging on 

system command execution 
requests 


val: 


abs: return integer absolute 

u3b5, vax: get processor type truth 
getenv: return 

floor, ceiling, remainder, absolute 
readlink: read 

putenv: change or add 

current form field to its default 
true, false: provide truth 

values: machine-dependent 


print formatted output of a 

list 

varargs: handle 

fpathconf: get configurable pathname 
sysconf: get configurable system 
.environ, .pref, 

unset: set and unset environment 
edit: text editor ( 

proc_ctl: control over 

/ns32000, pdpil, u3b, u3b2, u3b5, 


get option letter from argument 
readv: read 

writev: write 

assert: 

ve: 

get: get a 

sccsdiff: compare two 

virtual memory efficient way 
output of a varargs/ vprintf, 
editor based on ex 

more: 
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uucp directories and permissions file.............+ uucheck(1M) 
uucp file transport program .uusched(1M) 
uucp: networking support fileS.........sssssssseseeeseseensene uucp(4) 
uucp spool directory clean-up.. -uucleanup(1M) 
uucp status inquiry and job control -uustat(1C) 
UUCP SYSEM ..essssssseeee: suucico(1M) 
uucp, uulog, uuname ...uucp(1C) 
uugetty: set terminal type, modes,. ..uugetty(1M) 
uulog, uuname: UNIX-to-UNIX/.....+ ...uucp(1C) 


-uucp(1C) 
-uuto(1C) 
-uusched(1M) 
-uustat(1C) 


uuname: UNIX-to- UNIX system copy... 


ie the schedule for the uucp 
uustat: uucp status inquiry and job 


UWUEO, UUPICk: PUDIIC.....eererereeerereereeee uuto(1C) 
Uutry: try to contact remote system.. ..wutry(1M) 
uux: UNIX-to-UNIX. vee X(1C) 
uuxqt: execute remote command 


eg 
val: validate SCCS file. 7 
validate SCCS file.. 
valloc: aligned memory allocator 
value... 
value,.. 
value for environment name 
value functions.........+. 
value of a symbolic link... 
value to environment. 


“getenv(3C) 
w.floor(3M) 


....values(5) 
-Vprint{(3S) 
..varargs(5) 
..varargs(5) 


varargs argument list... as 
varargs: handle variable argument... 
variable argument list 
variables... 
variables... 
.variables: FACE files 
variables in core or in files 
variant of ex for casual users)... 
various process attributes......... 
vax: get processor type truth value 


VC! VETBION CONLTO] ..ssssessesessesesssssessesesscecenceneeeearensneensanssees «ve(1) 
VECLOF.sesereseeneee .getopt(3C) 
vector from file.. -readv(2SEQ) 


vector on a file... 
verify program assertion 
version Control... 
version of an SCCS file.. 
versions of an SCCS file... 
vfork: spawn new process in 8... 
vfprintf, vsprintf: print formatted... 
vi: screen-oriented (visual) display... 
view a file one full screen at a time... 
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map physical addresses into processs 
devtab: 

devdestroy: build and destroy 

- vfork: spawn new process in a 
vm_ctl: examine and change 

echo: put string on 

controlling terminal fvhangup: 
vmtune: tune system-wide 

pmap: display or alter parameters of 
vi: screen-oriented 

memory tuning parameters 
virtual-memory parameters 
filesystem 

fs, inode: format of file system 
formatted output of a varargs/ 

the controlling FMLI object 

a varargs/ vprintf, vfprintf, 
prtvtoc: print the 

prtvtoc: print the 

mkvtoc: populate 

vtoc: 


s_wait_barrier: initialize barrier, 


wait, waitpid: 

sigsuspend: 

process to stop or terminate 

stop or terminate wait, 
ftw: 


whodo: 
* who: 


vmtune: tune system- 
addformopt: add a form/SELECT 
we: 

fgetc, getw: get character or 
fputc, putw: put character or 
spellhist: unmatched spelling 

cd: change 

chdir: change 

getewd: get pathname of current 
pwd: 

specific alarms and/or the 
interface 

lseek: move read/ 

tirdwr: Transport Interface read/ 
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virtual address space.. 
virtual device table.. 


..vm_ctl(2SEQ) 


Wir tule] Gut pias icsssss5:3i-c:scsscssiseassssivecancesesssessssesinssasvanell echo(1F) 
virtually hangup the specified. .fvhangup(2SEQ) 
virtual-memory parameters.... -vmtune(1M) 


virtual-to-physical mapping devices . 


visual display editor based On €X.......sesesessssesesesereecerseeeee vi(1) 
vm_ctl: examine and change virtual.. ..vmn_ctl(2SEQ) 
vmtune: tune system-wide... .vmtune(1M) 
volcopy: make literal copy of. -volcopy(1M) 


Volume... et teen 
vprintf, vfprintf, vsprintf: print... 
vsig: synchronize a co-process with 
vsprintf: print formatted output of. 
VTOC of a block device......ssssseseeee 
VTOC of a standalone disk device 
VTOC on disks... 
VTOC partitioning drive: 
vtoc: VTOC partitioning driver 
wait at DATTICT......secsssseceseseeeeee 
wait: await completion of process... 
wait for a child process to stop or termina 
wait for a Signal ......sssssssssseee soit 
wait, waitpid: wait for a child. 
waitpid: wait for a child process to 
walk a file tree... 
wall: write to all users 


.- wait(2) 


We: WOrd COUN... we(1) 
wd: SSM SCSI disk controller wd(7) 
what: identify SCCS files........ what(1) 
whatis: describe what a command is. whatis(1) 
who is doing what........ 


who is on the system... 
who: who is on the system... 
whodo: who is doing what... 
wide virtual-memory parameters 
window option to a menu. 
word count 
word from a stream. 
word on 4 stream. 


«vmtune(1M) 
.addformopt(1M) 


working directory..... 
working directory 
working directory...... 
working directory name.. 
working indicator 
wp: SSM parallel line printer. 
write file pointer ......ssescseses 
write interface STREAMS module. 
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write: 
putpwent: 
putspent: 
wall: 
write: 
writev: 


open: open for reading or 
utmp, wimp: utmp and 
utmp, 

accounting records fwtmp, 
and execute command 
multiplexor driver 

tape interface 

xt: 

xB: 

bessel: jO, j1, jn, 
bessel: j0, j1, jn, yO, 


compress, uncompress, 


for dual-channel disk controller 
getzdinfo, getzdinfobyname: get 
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write on a file. ..write(2) 
write password file entry... putpwent(3C) 
write shadow password file entry. putspent(3X) 


write to all users....... see Wall(1) 
write to another user. » Write(1) 
write vector on a file.. writev(2SEQ) 


write: write on a file... 
write: write to another user. 
writev: write vector on a file. 


» Write(2) 
.-Write(1) 


WYItID .....cscserereenencnee: ..open(2) 
wtmp entry formats... ..utmp(4) 
wtmp: utmp and wtmp entry formats .-utmp(4) 
wtmpfix: manipulate connect........ fwtmp(1M) 
xargs: construct argument list(s). ..xargs(1) 
xs: Xylogics 781 terminal.......... woneX8(7) 
xt: Xylogics 472 MULITBUS magnetic...... .xt(7) 
Xylogics 472 MULITBUS magnetic tape interface.. .xt(7) 


woeX8(7) 
-bessel(3M) 
-bessel(3M) 


Xylogics 781 terminal multiplexor driver. 
y0, yl, yn: Bessel functions. 
yl, yn: Bessel functions....... 
yacc: yet another compiler-compiler.. se yace( 1) 
zcat: compress and expand data.. ..compress(1) 
zd: dual-channel disk controller....ccssssssssssseesseessseneesees 2d(7) 
zdformat: standalone disk formatter. 


Zdinfo StrUCtUTe......secscrersessrrceesen sodas .getzdinfo(3SEQ) 
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NAME 


© 


intro — introduction to system calls and error numbers 


#include <errno.h> 


DESCRIPTION 
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This section describes all of the system calls. Most of these calls have one or 
more error returns. An error condition is indicated by an otherwise impossi- 
ble returned value. This is almost always —1 or the NULL pointer; the individ- 
ual descriptions specify the details. An error number is also made available in 
the external variable errno. errno is not cleared on successful calls, so it 
should be tested only after an error has been indicated. 


Each system call description attempts to list all possible error numbers in 
alphabetical order. The following is a complete list of the error numbers in 
numerical order, and their names as defined in <errno.h>: 


1 EPERM "Not owner" ‘Typically this error indicates an attempt to modify a file 
in some way forbidden except to its owner or superuser. 
It is also returned for attempts by ordinary users to do 
things allowed only to the superuser. 


2 ENOENT "No such file or directory” 
This error occurs when a filename is specified and the 
file should exist but doesn’t, or when one of the direc- 
tories in a pathname does not exist. 


3 ESRCH "No such process” 
No process can be found corresponding to that specified 
by pid in kill(2) or ptrace(2). 


4 EINTR "Interrupted system call” 
An asynchronous signal (such as interrupt or quit), 
which the user has elected to catch, occurred during a 
system call. If execution is resumed after processing the 
signal, it will appear as if the interrupted system call 
returned this error condition. 


5 EIO "I/O error” Some physical I/O error has occurred. This error may in 
some cases occur on a call following the one to which it 
actually applies. 


6 ENXIO "No such device or address” 
YO on a special file refers to a subdevice which does not 
exist, or beyond the limits of the device. It may also 
occur when, for example, a tape drive is not on-line or no 
disk pack is loaded on a drive. 


7 E2BIG "Arg list too long” 
An argument list longer than ARG_MAX bytes is 
presented to a member of the exec(2) family. 


8 ENOEXEC "Exec format error” 
A request is made to execute a file which, although it 
has the appropriate permissions, does not start with a 
valid magic number [see a.out(4)]. 
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9 EBADF "Bad file number” 
Either a file descriptor isn’t open, or a read(2) [respec- 
tively, write(2)] request is made to a file which is open 
only for writing (respectively, reading). 


10 ECHILD "No child processes” 
A wait was executed by a process that had no existing 
or unwaited-for child processes. 


11 EAGAIN "No more processes” 
A fork failed because the system’s process table is full 
or the user is not allowed to create any more processes, 
or a system call failed because of insufficient swap space. 


12 ENOMEM "Not enough space” 
During an exec(2), brk(2), or sbrk(2), a program asks 
for more space than the system is able to supply. This is 
not a temporary condition; the maximum space size isa 
system parameter. 


13 EACCES "Permission denied” 
An attempt was made to access a file in a way forbidden 
by the protection system. 


14 EFAULT "Bad address” 
The system encountered a hardware fault in attempting 
to use an argument of a system call. 


15 ENOTBLK "Block device required” 
Anon-block file was mentioned where a block device was 
required, e.g., in mount(2). 


16 EBUSY "Device or resource busy” 
An attempt was made to mount a device that was 
already mounted or an attempt was made to dismount a 
device on which there is an active file (open file, current 
directory, mounted-on file, active text segment). It will 
also occur if an attempt is made to enable accounting 
when it is already enabled. The device or resource is 
currently unavailable. 


17 EEXIST "File exists” An existing file was mentioned in an inappropriate con- 
text, e.g., link(2). 


19 ENODEV "No such device” : 
An attempt was made to apply an inappropriate system 
call to a device; e.g., read a write-only device. 


20 ENOTDIR "Not a directory” 
Anon-directory was specified where a directory is 
required, for example in a path prefix or as an argument 
to chdir(2). 

21 EISDIR "Is a directory” 
An attempt was made to write on a directory. 


22 EINVAL "Invalid argument” 
Some invalid argument (e.g., dismounting a 
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.non-mounted device; mentioning an undefined signal in 
signal(2) or kill(2); reading or writing a file for which 
Iseek(2) has generated a negative pointer). Also set by 
the math functions described in the (3M) entries of this 
manual. 


23 ENFILE "File table overflow" 
The system file table is full, and temporarily no more 
opens can be accepted. 


24 EMFILE "Too many open files” 
No process may have more than NOFILES (default 20) 
descriptors open at a time. Refer to NOFILES later in 
this introduction. 


25 ENOTTY "Not a character device (or) Not a typewriter” 
An attempt was made to ioctl(2) a file that is not a char- 
acter-special device. 


26 ETXTBSY "Text file busy” 
An attempt was made to execute a shared-text program 
that is currently open for writing. Also an attempt to 
open for writing or to remove a shared-text program 
that is being executed. 


27 EFBIG "File too large” 
The size of a file exceeded the maximum file size or 
ULIMIT (see ulimit(2)). 


28 ENOSPC "No space left on device” 
During a write(2) to an ordinary file, or the creation of a 
symbolic link, or a directory, there is no free space left 
on the file system. During the creation of a directory, a 
special file, a symbolic link or a link to a file, the direc- 
tory in which the entry for the new file is being placed 
cannot be extended because there is no space left on the 
file system containing that directory. During the cre- 
ation of a file system object, there are no more inodes 
available in that file system. In fentl(2), the setting or 
removing of record locks on a file cannot be accom- 
plished because there are no more record entries left on 
the system. 


29 ESPIPE “Illegal seek” 
An lseek(2) was issued to a pipe. 


30 EROFS "Read-only filesystem” 
An attempt to modify a file or directory was made on a 
device mounted read-only. 


31 EMLINK "Too many links” 
An attempt to make more than the maximum number of 
links (default MAXLINK, see <sys/param.h>) to a file. 


32 EPIPE "Broken pipe” A write on a pipe for which there is no process to read 
the data. This condition normally generates a signal; 
the error is returned if the signal is ignored. 
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33 EDOM "Math argument” 
The argument of a function in the math package (3M) is 
out of the domain of the function. 


34 ERANGE "Result too large” 
The value of a function in the math package (3M) is not 
representable within machine precision. 


85 ENOMSG "No message of desired type” 
An attempt was made to receive a message of a type 
that does not exist on the specified message queue [see 
msgop(2)]. 


86 EIDRM "Identifier removed” 
This error is returned to processes that resume execu- 
tion due to the removal of an identifier from the filesys- 
tem’s name space [see msgctl(2), semctl(2), and 
shmcetl(2)]. 


37-44 Reserved numbers 


45 EDEADLK “Deadlock” 
A deadlock situation was detected and avoided. This 
error pertains to file and record locking. 


46 ENOLCK "No lock” In fent](2) the setting or removing of record locks on a 
file cannot be accomplished because there are no more 
record entries left on the system. 


60 ENOSTR "Not a stream” 
A putmsg(2) or getmsg(2) system call was attempted 
on a file descriptor that is not a STREAMS device. 


62 ETIME "Stream ioctl timeout” 
The timer set for a STREAMS ioctI(2) call has expired. 
The cause of this error is device specific and could indi- 
cate either a hardware or software failure, or perhaps a 
timeout value that is too short for the specific operation. 
The status of the ioctl(2) operation is indeterminate. 


63 ENOSR "No stream resources” 
The requested operation cannot be completed currently 
due to the exhaustion of internal STREAMS resources. 


65 ENOPKG "No package” 
This error occurs when users attempt to use a system 
call from a package which has not been installed. 


77 EBADMSG “Bad message” 
During a read(2), getmsg(2), or ioctl(2) I_RECVFD sys- 
tem call to a STREAMS device, an invalid message has 
come to the head of the queue. Examples are: 


read(2) - control information or a passed file descriptor. 
getmsg(2) - passed file descriptor. 
ioctl(2) - control or data information. 
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88 ENAMETOOLONG "File name too long” 
Acomponent of a path name exceeded NAME_MAX characters, or an 
entire path name exceeded PATH_MAX characters. A path name con- 
taining symbolic links may also produce this error if the symbolic link 
expansion exceeds PATH_MAX characters or contains a component big- 
ger than NAME_MAX characters. 


89 OOP "Too many levels of symbolic links” 
A path name lookup involved more than n symbolic links, where n is 
binary configurable (default is 8). 


The following symbolic constants are used to describe various system limits in 
the following sections. The actual values can be found in <limits.h>. 


ARG_MAX 
Maximum length of arguments for the exec(2) function in bytes, 
including environment data 


CHILD_MAX 
Maximum number of simultaneous processes per real user ID 


NAME_MAX 
Maximum number of bytes in a filename (the count excludes a ter- 
minating null) 

PATH_MAX 
Maximum number of bytes in a pathname (the count excludes a ter- 
minating null) 


PIPE_BUF 
Maximum number of bytes which can be written atomically to a pipe 


NGROUPS_MAX 
Maximum number of simultaneous supplementary group IDs per pro- 
cess. 


The following symbolic constants are used to describe various system limits in 
the following sections. The actual values can be found in <sys/param.h>. 


MAXPID 
The maximum process ID 


MAXLINK 
The maximum number of links to a file 


MAXUID 
The maximum user ID 


DEFINITIONS 
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Process ID. Each active process in the system is uniquely identified by a posi- 
tive integer called a process ID. The range of this ID is from 1 to MAXPID. 


Parent Process ID. A new process is created by a currently active process 
[see fork(2)]. The parent process ID of a process is the process ID of its cre- 
ator. 


Process Group ID. Each active process is a member of a process group that is 
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identified by a positive integer called the process group ID. This ID is the pro- 
cess ID of the group leader. This grouping permits the signaling of related 
processes [see kill(2)]. 


Session Group. Each active process is a member of a session group. This 
grouping permits the exchange of a foreground process group and its related 
job-control mechanisms. 


Foreground Process Group ID. Each active process can be a member of a 
process group that is identified by a positive integer called the forground pro- 
cess group. ID. This grouping is used to terminate a group of related processes 
upon termination of one of the processes in the group [see exit(2) and sig- 
nal(2)]. 


Real User ID and Real Group Each user allowed on the system is identified 
by a positive integer (0 to MAXUID) called a real user ID. 


Each user is also a member of a group. The group is identified by a positive 
integer called the real group ID. 


An active process has a real user ID and real group ID that are set to the real 
user ID and real group ID, respectively, of the user responsible for the creation 
of the process. 


Effective User ID and Effective Group An active process has an effective 
user ID and an effective group ID that are used to determine file access permis- 
sions (see below). The effective user ID and effective group ID are equal to the 
process’s real user ID and real group ID respectively, unless the process or one 
of its ancestors evolved from a file that had the set-user-ID bit or set-group ID 
bit set [see exec(2)]. 


Supplementary Group ID. Each user on the system can be a member of 
NGROUPS_MAX supplementary groups (in addition to the group ID). Supple- 
mentary groups are used along with the effective group ID in determining file 
access privileges. They are established when a user logs in [see login(1)] to 
the system. The file /etc/group lists all the supplementary groups and their 
members. 


Superuser. A process is recognized as a superuser process and is granted spe- 
cial privileges, such as immunity from file permissions, if its effective user ID 
is 0. 


Special Processes. The processes with a process ID of 0 and a process ID of 1 
are special processes and are referred to as procO and procl. 


proc0 is the scheduler. proc] is the initialization process (init). proclis the 
ancestor of every other process in the system and is used to control the process 
structure. 
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File Descriptor. A file descriptor is a small integer used to do I/O on a file. 
The value of a file descriptor is from 0 to (NOFILES - 1). A process may have no 
more than NOFILES. file descriptors open simultaneously. A file descriptor is 
returned by system calls such as open(2), or pipe(2). The file descriptor is 


- used as an argument by calls such as read(2), write(2), ioctl(2), and close(2). 


NOFILES. This is the maximum number of file descriptors that a process may 
have open simultaneously. NOFILES is set when the kernel is configured; the 
default operating system value for NOFILES is 20. This number can be 
changed by reconfiguring the kernel (refer to the System Administration 
Guide). Every process, on creation, can have up to 20 open file descriptors. In 
order for a process to get more than 20 file descriptors, the process must call 
setdtablesize(2seq). The argument to setdtablesize cannot exceed the value 
of NOFILES. The current value of the file descriptor table size for a process 
can be determined using the getdtablesize(2seq) system call. The getdta- 
blemax(2seq) system cal] returns the highest numbered file descriptor cur- 
rently opened. 


File Name. Names consisting of 1 to NAME_MAX characters may be used to 
name an ordinary file, special file or directory. 


These characters may be selected from the set of all character values exclud- 
ing \0 (null) and the ASCTI code for / (slash). 


Note that it is generally unwise to use *, ?, [, or ] as part of filenames because 
of the special meaning attached to these characters by the shell [see sh(1)]. 
Although permitted, the use of unprintable characters in filenames should be 
avoided. 


Path Name and Path Prefix. A pathname is a null-terminated character 
string starting with an optional slash (/), followed by zero or more directory 
names separated by slashes, optionally followed by a filename. The total 
length of a path name must be less than PATH_MAX characters. 


If a pathname begins with a slash, the path search begins at the root direc- 
tory. Otherwise, the search begins from the current working directory. 


Aslash by itself names the root directory. 


Unless specifically stated otherwise, the null pathname is treated as if it 
named a non-existent file. 


Directory. A directory is a special type of file containing entries which are 
references to other files. Directory entries are called links. By convention, a 
directory contains at least two links, . and .., referred to as dot and dot-dot 
respectively. Dot refers to the directory itself and dot-dot refers to its parent 
directory. 


Root Directory and Current Working Directory. Each process has asso- 
ciated with it a concept of a root directory and a current working directory for 
the purpose of resolving pathname searches. The root directory of a process 
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need not be the root directory of the root filesystem. 


File Access Permissions. Every file in the file system has a set of access per- 
missions. These permissions are used in determining whether a process may 
perform a requested operation on the file (such as opening a file for writing). 
Access permissions are established at the time a file is created. They may be 
changed at some later time through the chmod(2) call. 


File access is broken down according to whether a file may be: read, written, 
or executed. Directory files use the execute permission to control if the direc- 
tory may be searched. 


File access permissions are interpreted by the system as they apply to three 
different classes of user: the owner of the file, those users in the file’s group, 
anyone else. Every file has an independent set of access permissions for each 
of these classes. When an access check is made, the system decides if permis- 
sion should be granted by checking the access information applicable to the 
caller. 


Read, write, and execute/search permissions on a file are granted to a process 
if one or more of the following are true: 


The effective user ID of the process is superuser. 


The effective user ID of the process matches the user ID of the owner of 
the file and the appropriate access bit of the owner portion (0700) of 
the file mode is set. 


The effective user ID of the process does not match the user ID of the 
owner of the file, and the effective group ID of the process, or one of its 
supplementary group IDs, matches the group of the file and the appro- 
priate access bit of the group portion (0070) of the file mode is set. 


The effective user ID of the process does not match the user ID of the 
owner of the file, and the effective group ID of the process, or one of its 
supplementary group IDs, does not match the group ID of the file, and 
the appropriate access bit of the other portion (0007) of the file mode is 
set. 


Otherwise, the corresponding permissions are denied. 


Message Queue Identifier. A message queue identifier (msqid) is a unique’ 
positive integer created by a msgget(2) system call. Each msqid has a mes- 
sage queue and a data structure associated with it. The data structure is 
referred to as msqid_ds and contains the following members: 


struct ipc_perm msg_perm; 

struct msg *msg_first; 

struct msg *msg_last; 
ushort msg_cbytes; 

ushort msg_qnum; 

ushort msg_qbytes; 

pid_t msg_lspid; 

pid_t msg_lrpid; 

time_t msg_stime; 
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time_t msg_rtime; 
time_t msg_ctime; 


msg_perm is an ipc_perm structure that specifies the message operation 
permission (see below). This structure includes the following members: 


uid_t cuid; 
gid_t cgid; 
uid t uid; 
gid _t gid; 


ushort mode; 
ushort seq; 
key _t key; 


msg *msg_first 
msg *msg_last 
msg_cbytes 
msg_qnum 
msg_qbytes 


mesg_Ispid 
mesg_lIrpid 


msg_stime 
msg_rtime 
msg_ctime 


/* creator user id */ 

/* creator group id */ 

/* user id */ 

/* group id */ 

/* xr/w permission */ 

/* slot usage sequence # */ 
/* key */ 


is a pointer to the first message on the queue. 

is a pointer to the last message on the queue. 

is the current number of bytes on the queue. 

is the number of messages currently on the queue. 


is the maximum number of bytes allowed on the 
queue. 


is the process ID of the last process that performed 
a@ msgsnd operation. 


is the process ID of the last process that performed 
a@ msgrcv operation. 


is the time of the last msgsnd operation. 
is the time of the last msgrev operation 


is the time of the last msgetl(2) operation that 
changed a member of the above structure. 


Message Operation Permissions. In the msgop(2) and msgctl(2) system 
call descriptions, the permission required for an operation is given as 
"{token}", where "token" is the type of permission needed, interpreted as fol- 


lows: 


00400 
00200 
00040 
00020 
00004 
00002 


Read by owner 
Write by owner 
Read by group 
Write by group 
Read by others 
Write by others 


Read and write permissions on a msqid are granted to a process if one or 
more of the following are true: 


The effective user ID of the process is superuser. 


The effective user ID of the process matches msg_perm.cuid or 
msg_perm.uid in the data structure associated with msqid and the 
appropriate bit of the user portion (0600) of msg_perm.mode is set. 


The effective group ID of the process matches msg_perm.cgid or 
msg_perm.gid and the appropriate bit of the group portion (060) of 
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msg_perm.mode is set. 
The appropriate bit of the other portion (006) of msg_perm.mode is @ 
set. 


Otherwise, the corresponding permissions are denied. 


Semaphore Identifier. A semaphore identifier (semid) is a unique positive 
integer created by a semget(2) system call. Each semid has a set of sema- 
phores and a data structure associated with it. The data structure is referred 
to as semid_ds and contains the following members: 


struct ipc_perm sem_perm;/* operation permission struct */ 


struct sem *sem_base; /* ptr to first semaphore in set */ 
ushort sem_nsems; /* number of sems in set */ 

time_t sem_otime; /* last operation time */ 

time_t sem_ctime; /* last change time */ 


sem_perm 


sem_nsems 


sem_otime 


sem_ctime 


/* Times measured in secs since */ 
/* 00:00:00 uTc, Jan. 1, 1970 */ 


is an ipe_perm structure that specifies the semaphore 
operation permission (see below). This structure 
includes the following members: 


uid_t uid; /* user id */ 

gid_t gid; /* group id */ 

uid_t cuid; /* creator user id */ 

gid_t cgid; /* creator group id */ © 
ushort mode; /* x/a permission */ 

ushort seq; /* slot usage sequence number */ 
key t key; /* key */ 


is equal to the number of semaphores in the set. Each 
semaphore in the set is referenced by a positive integer 
referred to asa sem_num. sem_num values run 
sequentially from 0 to the value of sem_nsems minus 1. 


is the time of the last semop(2) operation. 


is the time of the last semct](2) operation that changed 
a member of the above structure. 


Asemaphore is a data structure called sem that contains the following mem- 


bers: 


ushort semval; /* semaphore value */ 


pid_t 


sempid; /* pid of last operation */ 


ushort semncnt; /* # awaiting semval > cval */ 
ushort semzcnt; /* # awaiting semval = 0 */ 


semval 


sempid 


is a non-negative integer which is the actual value of the 
semphore. 


is equal to the process ID of the last process that per- 
formed a semaphore operation on this semaphore. 
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semnecnt is a count of the number of processes that are currently 
suspended awaiting this semaphore’s semval to become 
greater than its current value. 


semzcnt is a count of the number of processes that are currently 
suspended awaiting this semaphore’s semval to become 
zero. 


Semaphore Operation Permissions. 


In the semop(2) and semctl(2) system call descriptions, the permission 
required for an operation is given as "{token}", where "token" is the type of 
permission needed interpreted as follows: 


00400 Read by owner 
00200 Alter by owner 
00040 Read by group 
00020 Alter by group 
00004 Read by others 
00002 Alter by others 


Read and alter permissions on a semid are granted to a process if one or more 
of the following are true: 


The effective user ID of the process is superuser. 


The effective user ID of the process matches sem_perm.cuid or 
sem_perm.uid in the data structure associated with semid and the 
appropriate bit of the user portion (0600) of sem_perm.mode is set. 


The effective group ID of the process matches sem_perm.cgid or 
sem_perm.gid and the appropriate bit of the group portion (060) of 
sem_perm.mode is set. 


The appropriate bit of the other portion (006) of sem_perm.mode is 
set. 
Otherwise, the corresponding permissions are denied. 


Shared Memory Identifier. A shared memory identifier shmid, is a unique 
positive integer created by a shmget(2) system call. Each shmid has a seg- 
ment of memory (referred to as a shared memory segment) and a data struc- 
ture associated with it. (Note that these shared memory segments must be 
explicitly removed by the user after the last reference to them is removed.) 
The data structure is referred to as shmid_ds and contains the following 


members: 
struct ipc_perm shm_perm;/* operation permission struct */ 
int shm_segsz; /* size of segment */ 
struct region *shm_reg; /*ptr to region structure */ 
char pad[4]; /* for swap compatibility */ 
pid_t shm_lpid; /* pid of last operation */ 
pid_t shm_cpid; /* creator pid */ 
ushort shm_nattch; /* number of current attaches */ 
ushort shm_cnattch; /* used only for shminfo */ 
time_t shm_atime; /* last attach time */ 


12/89 11 


INTRO(2) 


12 


DYNIX/ptx 
time_t shm_dtime; /* last detach time */ 
time_t shm_ctime; /* last change time */ 
/* Times measured in secs since */ 


/* 00:00:00 utc, Jan. 1, 1970 */ 


shm_perm is an ipe_perm structure that specifies the shared 
memory operation permission (see below). This struc- 
ture includes the following members: 
uid_t cuid; /* creator user id */ 
gid_t cgid; /* creator group id */ 
uid_t uid; /* user id */ 
gid_t gid; /* group id */ 
ushort mode; /* r/w permission */ 
ushort seq; /* slot usage sequence # */ 
key t key; /* key */ 
shm_segsz specifies the size of the shared memory segment in 
bytes. 
shm_cpid is the process id of the process that created the shared 


shm_Ipid 


shm_nattch 


shm_atime 
shm_dtime 


shm_ctime 


memory identifier. 


is the process id of the last process that performed a 
shmop(2) operation. This field is currently not main- 
tained on a shmdt(2) operation. 


is the number of processes that currently have this seg- 


ment attached. 
is the time of the last shmat(2) operation, © 


is the time of the last shmdt(2) operation. This field is 
currently not maintained. 


is the time of the last shmctl(2) operation that changed 
one of the members of the above structure. 


Shared Memory Operation Permissions. In the shmop(2) and shmetl(2) 
system call descriptions, the permission required for an operation is given as 
"{token}", where "token" is the type of permission needed interpreted as fol- 


lows: 


00400 
00200 
00040 
00020 
00004 
00002 


Read by owner 
Write by owner 
Read by group 
Write by group 
Read by others 
Write by others 


Read and write permissions on a shmid are granted to a process if one or 
more of the following are true: 


The effective user ID of the process is superuser. 


shm_perm.uid in the data structure associated with shmid and the 


The effective user ID of the process matches shm_perm.cuid or @ 


appropriate bit of the user portion (0600) of shm_perm.mode is set. 
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The effective group ID of the process matches shm_perm.cgid or 
shm_perm.gid and the appropriate bit of the group portion (060) of 
shm_perm.mode is set. 


The appropriate bit of the other portion (06) of shm_perm.mode is 
set. 
Otherwise, the corresponding permissions are denied. 


STREAMS. A set of kernel mechanisms that support the development of net- 
work services and data communication drivers. It defines interface standards 
for character input/output within the kernel and between the kernel and user 
level processes. The STREAMS mechanism is composed of utility routines, ker- 
nel facilities and a set of data structures. 


Stream. A stream is a full-duplex data path within the kernel between a user 
process and driver routines. The primary components are a stream head, a 
driver and zero or more modules between the stream head and driver. A 
stream is analogous to a shell pipeline except that data flow and processing 
are bidirectional. 


Stream Head. In a stream, the stream head is the end of the stream that pro- 
vides the interface between the stream and a user process. The principle func- 
tions of the stream head are processing STREAMS-related system calls, and 
passing data and information between a user process and the stream. 


Driver. In a stream, the driver provides the interface between peripheral 
hardware and the stream. A driver can also be a pseudodriver, such as a mul- 
tiplexor or log driver [see log(7)], which is not associated with a hardware 
device. 


Module. A module is an entity containing processing routines for input and 
output data. It always exists in the middle of a stream, between the stream’s 
head and a driver. A module is the STREAMS counterpart to the commands in 
a shell pipeline except that a module contains a pair of functions which allow 
independent bidirectional (downstream and upstream) data flow and process- 
ing. 


Downstream. In a stream, the direction from stream head to driver. 
Upstream. In a stream, the direction from driver to stream head. 


Message. In a stream, one or more blocks of data or information, with associ- 
ated STREAMS control structures. Messages can be of several defined types, 
which identify the message contents. Messages are the only means of 
transferring data and communicating within a stream. 


Message Queue. In a stream, a linked list of messages awaiting processing 
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by a module or driver. 


Read Queue. In a stream, the message queue in a module or driver contain- 
ing messages moving upstream. 


Write Queue. In a stream, the message queue in a module or driver contain- 
ing messages moving downstream. 


Multiplexor. A multiplexor is a driver that allows streams associated with 
several user processes to be connected to a single driver, or several drivers to 
be connected to a single user process. STREAMS does not provide a general 
multiplexing driver, but does provide the facilities for constructing them, and 
for connecting multiplexed configurations of streams. 


SEE ALSO 
intro(3) 
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NAME 


® SYNOPSIS 


ACCESS(2) 


access — determine accessibility of a file 


int access (path, amode) 


char *path; 
int amode; 


DESCRIPTION 
path points to a pathname naming a file. access checks the named file for 
accessibility according to the bit pattern contained in amode, using the real 
user ID in place of the effective user ID and the real group ID in place of the 
effective group ID, and the supplementary group ID. The bit pattern contained 
in amode is constructed as follows: 
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04 read 
02 write 
01 execute (search) 


00 check existence of file 


Access to the file is denied if one or more of the following are true: 


[EACCES] 
[EACCES] 
[EFAULT] 

(EIO] 

[ELOOP] 
[ENOENT] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 


[ENOTDIR] 
[ENOENT] 
[EROFS] 


[ETXTBSY] 


Search permission is denied on a component of the path 
prefix. 


Permission bits of the file mode do not permit the 
requested access. 


path points outside the allocated address space for the 
process. 


An V/0 error occurred while reading from or writing to 
the file system. . 


Too many symbolic links were encountered in translat- 
ing path. 


Read, write, or execute (search) permission is requested 
for a null pathname. 


path was longer than PATH_MAX characters. 


path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


Acomponent of the path prefix is not a directory. 
The named file does not exist. 


Write access is requested for a file on a read-only filesys- 
tem. 


Write access is requested for a pure procedure (shared 
text) file that is being executed. 
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The owner of a file has permission checked with respect to the owner read, 
write, and execute mode bits. Members of the file’s group other than the @ 
owner have permissions checked with respect to the group mode bits, and all 
others have permissions checked with respect to the other mode bits. A pro- 
cess is a member of a file’s group if the group ID appears in its supplementary 
group list or is its effective group ID. 
SEE ALSO 
chmod(2), stat(2) 


DIAGNOSTICS 
If the requested access is permitted, a value of 0 is returned. Otherwise, a 
value of ~1 is returned and errno is set to indicate the error. 
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NAME 
a) acct — enable or disable process accounting 


SYNOPSIS 
int acct (path) 
char *path; 


DESCRIPTION 
acct is used to enable or disable the system process accounting routine. If the 
routine is enabled, an accounting record will be written on an accounting file 
for each process that terminates. Termination can be caused by one of two 
things: an exit call or a signal [see exit(2) and signal(2)]. The effective user 
ID of the calling process must be superuser to use this call. 


path points to a pathname naming the accounting file. The accounting file 
format is given in acct(4). 


The accounting routine is enabled if path is non-zero and no errors occur dur- 
ing the system call. It is disabled if path is zero and no errors occur during 


the system call. 

acct will fail if one or more of the following are true: 

[EACCES] The file named by path is not an ordinary file. 

[EBUSY] An attempt is being made to enable accounting when it 
is already enabled. 

(EFAULT] path points to an illegal address. 

(EIO] An V/O error occurred while reading from or writing to 
the file system. 

{ELOOP] Too many symbolic links were encountered in translat- 
ing path. 


[ENAMETOOLONG] _ path was longer than PATH_MAX characters. 


[ENAMETOOLONG] path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 


ters. 
[ENAMETOOLONG] Acomponent of path was longer than NAME_MAX char- 
acters. 
[ENOENT] One or more components of the accounting file path- 
name do not exist. 
(ENOTDIR] Acomponent of the path prefix is not a directory. 
{EPERM] The effective user of the calling process is not superuser. 
[EROFS] The named file resides on a read-only filesystem. 
SEE ALSO 
exit(2), signal(2), acct(4) 
DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
& is returned and errno is set to indicate the error. 
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NAME 


) SYNOPSIS 


alarm — set a process alarm clock 


unsigned alarm (sec) 
unsigned sec; 


DESCRIPTION 


alarm instructs the alarm clock of the calling process to send the signal 
SIGALRM to the calling process after the number of real time seconds specified 
by sec have elapsed [see signal(2)]. 


Alarm requests are not stacked; successive calls reset the alarm clock of the 
calling process. 


If sec is 0, any previously made alarm request is canceled. 


If the process does a fork(2), the alarm request is cleared in the child process. 
Alarm requests remain pending across the exec(2) family of system calls. 


SEE ALSO 


fork(2), exec(2), pause(2), signal(2), sigpause(2), sigset(2), sigaction(2) 


DIAGNOSTICS 
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alarm returns the amount of time previously remaining in the alarm clock of 
the calling process. 


DYNIX/ptx BRK(2) 


brk, sbrk — change data segment space allocation 


SYNOPSIS 


int brk (endds) 
char *endds; 


char *sbrk (incr) 
int incr; 


DESCRIPTION 


brk and sbrk are used to change dynamically the amount of space allocated 
for the calling process’s data segment (see exec(2)). The change is made by 
resetting the process’s break value and allocating the appropriate amount of 
space. The break value is the address of the first location beyond the end of 
the data segment. The amount of allocated space increases as the break value 
increases. Newly allocated space is set to zero. If, however, the same memory 
space is reallocated to the same process its contents are undefined. 


brk sets the break value to endds and changes the allocated space accord- 
ingly. 

sbrk adds incr bytes to the break value and changes the allocated space 
accordingly. incr can be negative, in which case the amount of allocated 
space is decreased. 

brk and sbrk fails without making any change in the allocated space if one or 
more of the following are true: 


[EAGAIN] Swap space required to back up the memory being allocated is 
temporarily unavailable. 


(EINVAL) If the change would force text to be deleted. 
[ENOMEM] Such a change would result in more space being allocated than 
is allowed by the system-imposed maximum process size (see 


ulimit(2)), or the new data space would overlap with previously 
allocated memory (see shmop(2), mmap(2seq)). 


SEE ALSO 


exec(2), mmap(2seq), shmop(2), ulimit(2), end(3C) 


DIAGNOSTICS 


Upon successful completion, brk returns a value of 0 and sbrk returns the 
old break value. Otherwise, a value of —1 is returned and errno is set to indi- 
cate the error. 
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NAME 


CHDIR(2) 


chdir — change working directory 


SYNOPSIS 
int chdir (path) 
char *path; 


DESCRIPTION 


path points to the pathname of a directory. chdir causes the named direc- 
tory to become the current working directory, the starting point for path 
searches for pathnames not beginning with / (slash). 


ehdir will fail and the current working directory will be unchanged if one or 
more of the following are true: 


[EACCES] 


[EFAULT] 


183) (0)| 


[ELOOP] 


[ENAMETOOLONG}] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


{ENOENT] 
(ENOTDIR] 


SEE ALSO 
chroot(2) 


DIAGNOSTICS 


Search permission is denied for any component of the 
path name. 


path points outside the allocated address space of the 
process. 


An I/O error occurred while reading from or writing to 
the file system. 


Too many symbolic links were encountered in translat- 
ing path. 


path was longer than PATH_MAX characters. 


path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


The named directory does not exist. 
Acomponent of the pathname is not a directory. 


Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 
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NAME 


© SYNOPSIS 


chmod — change mode of file 


#include <sys/types.h> 
int chmod (path, mode) 
‘char *path; 

mode_t mode; 


DESCRIPTION 
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path points to a path name naming a file. chmod sets the access permission 
portion of the named file’s mode according to the bit pattern contained in 
mode. 


Access permission bits are interpreted as follows: 


04000 Set user ID on execution. 
020#0 Set group ID on execution if # is 7, 5, 8, or 1 
Enable mandatory file/record locking if # is 6, 4, 2, or 0 
01000 Save text image after execution. 
00400 Read by owner. 
00200 Write by owner. 
00100 Execute (search if a directory) by owner. 
00070 Read, write, execute (search) by group. 
00007 Read, write, execute (search) by others. 


The effective user ID of the process must match the owner of the file or be 
superuser to change the mode of a file. 


If the effective user ID of the process is not superuser and the file is not a 
directory, mode bit 01000 (save text image on execution) is cleared. 


If the effective user ID of the process is not superuser and if the group ID of the 
file does not match the effective group ID of the process or one of the supple- 
mentary group IDs of the process, the mode bit 02000 (set group ID on execu- 
tion) is cleared. Clearing the set group ID bit may disable mandatory record 
locking on that file. 


Ifa 410 executable file has the sticky bit (mode bit 01000) set, the operating 
system will not delete the program text from the swap area when the last user 
process terminates. If a 413 executable file has the sticky bit set, the operat- 
ing system will not delete the program text from memory when the last user 
process terminates. In either case, if the sticky bit is set the text will already 
be available (either in a swap area or in memory) when the next user of the 
file executes it, thus making execution faster. 


If the executing process is not owned by the superuser, chmod masks the 
sticky-bit but does not return an error. 


If a directory is writable and has the sticky bit set, files within that directory 
can be removed only if one or more of the following is true (see unlink(2)): 


the user owns the file 
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the user owns the directory 
the file is writable by the user 
the user is the superuser 


If the mode bit 02000 (set group ID on execution) is set and the mode bit 00010 
(execute or search by group) is not set, mandatory file/record locking will exist 
on a regular file. This may affect future calls to open(2), creat(2), read(2), 
write(2), and mmap(2seq) on this file. 


chmod will fail and the file mode will be unchanged if one or more of the fol- 


lowing are true: 
[EACCES] 


(EFAULT] 

[EIO] 

[ELOOP] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 


(ENOENT] 
(ENOTDIR] 
[EPERM] 


{EROFS] 
SEE ALSO 


Search permission is denied on a component of the path 
prefix. 


path points outside the allocated address space of the 
process. 


An I/O error occurred while reading from or writing to 
the file system. 


Too many symbolic links were encountered in translat- 
ing path. 


path was longer than PATH_MAX characters. 


path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


The named file does not exist. 
Acomponent of the path prefix is not a directory. 


The effective user ID does not match the owner of the 
file and the effective user ID is not superuser. 


The named file resides on a read-only file system. 


chmod(1), chown(2), creat(2), fentl(2), mknod(2), open(2), read(2), write(2), 


mmap(2seq) 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 
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NAME 
& chown — change owner and group of a file 

SYNOPSIS 
int chown (path, owner, group) 
char *path; 
uid_t owner; 
gid_t group; 

DESCRIPTION 
path points to a pathname naming a file. The owner ID and group ID of the 
named file are set to the numeric values contained in owner and group 
respectively. 
Only processes with effective user ID equal to the superuser may change the 
ownership of a file. 


If owner or group is specified as (uid_t)-1 or (gid_t)-1, the corresponding ID of 
the file remains unchanged. 


If chown is invoked by other than the superuser, the set-user-ID and set- 
group-ID bits of the file mode, 04000 and 02000 respectively, will be cleared. 


chown will fail and the owner and group of the named file will remain 
unchanged if one or more of the following are true: 


[EACCES] Search permission is denied on a component of the path 
prefix. 

[EFAULT) path points outside the allocated address space of the 

@ process. 

[EIO} An V/O error occurred while reading from or writing to 
the file system. 

{ELOOP] Too many symbolic links were encountered in translat- 
ing path. 


[ENAMETOOLONG] _ path was longer than PATH_MAX characters. 


f[ENAMETOOLONG] . path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 


ters. 

[ENAMETOOLONG] Acomponent of path was longer than NAME_MAX char- 
acters. 

[ENOENT] The named file does not exist. 

[ENOTDIR] Acomponent of the path prefix is not a directory. 

[EPERM] The effective user ID does not match the owner of the 
file and the effective user ID is not superuser. 

(EROFS] The named file resides on a read-only filesystem. 

SEE ALSO 


chown(1), chmod(2) 


DIAGNOSTICS 
@ Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 
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NAME 
chroot — change root directory 


SYNOPSIS 
int chroot (path) 
char *path; 


DESCRIPTION 
path points to a pathname naming a directory. chroot causes the named 
directory to become the root directory, the starting point for path searches for 
pathnames beginning with /. The user’s working directory is unaffected by the 
chroot system call. 


The effective user ID of the process must be superuser to change the root 
directory. 


The .. entry in the root directory is interpreted to mean the root directory 
itself. Thus, .. cannot be used to access files outside the subtree rooted at the 
root directory. 


chroot will fail and the root directory will remain unchanged if one or more of 
the following are true: 


[EFAULT] path points outside the allocated address space of the 
process. 

[EIO] An V/O error occurred while reading from or writing to 
the file system. 

[ELOOP] Too many symbolic links were encountered in translat- 
ing path. 


[ENAMETOOLONG] _ path was longer than PATH_MAX characters. 


[ENAMETOOLONG] path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 


ters. 
[ENAMETOOLONG] Acomponent of path was longer than NAME_MAX char- 
acters. 
[ENOENT] The named directory does not exist. 
[ENOTDIR] Any component of the pathname is not a directory. 
(EPERM] The effective user ID is not superuser. 
SEE ALSO 
chdir(2) 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
js returned and errno is set to indicate the error. 
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NAME 


close — close a file descriptor 


SYNOPSIS 


int close (fildes) 
int fildes; 


DESCRIPTION 


fildes is a file descriptor obtained from a creat, open, dup, fentl, or pipe 
system call. close closes the file descriptor indicated by fildes. All outstand- 
ing record locks owned by the process (on the file indicated by fildes) are 
removed. Existing maps created by mmap(2seq) using this file descriptor 
remain mapped. 


If a STREAMS file (see intro(2)) is closed, and the calling process had previ- 
ously registered to receive a SIGPOLL signal (see signal(2), sigset(2), and 
sigaction(2)) for events associated with that file (see I_SETSIG in 
streamio(7)), the calling process is unregistered for events associated with 
the file. The last close for a stream causes the stream associated with fildes 
to be dismantled. If O_NDELAY is not set and there have been no signals 
posted for the stream, close waits up to 15 seconds, for each module and 
driver, for any output to drain before dismantling the stream. If the O_NDE- 
LAY flag is set or if there are any pending signals, close does not wait for out- 
put to drain, and dismantles the stream immediately. 


The named file is closed unless one or more of the following are true: 


{EBADF] fildes is not a valid open file descriptor. 
(EINTR] A signal was caught during the close system call. 
SEE ALSO 


creat(2), dup(2), exec(2), fentl(2), intro(2), open(2), pipe(2), signal(2), sigset(2), 
sigaction(2), streamio(7) 


DIAGNOSTICS 
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Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


creat — create a new file or rewrite an existing one 


SYNOPSIS 


#include <sys/types.h> 
int creat (path, mode) 
char *path; 

mode_t mode; 


DESCRIPTION 
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creat creates a new ordinary file or prepares to rewrite an existing file named 
by the pathname pointed to by path. 


If the file exists, the length is truncated to 0 and the mode and owner are 
unchanged. Otherwise, the file’s owner ID is set to the effective user ID of the 
process, the group ID of the file is set to the group ID of the directory in which 
this file is being created and the low-order 12 bits of the file mode are set to 
the value of mode modified as follows: 


All bits set in the process’s file mode creation mask are cleared (see 
umask(2)). 


The save text image after execution bit of the modeis 
cleared (see chmod(2)). 


If the effective user ID of the process is not superuser and if the group 
ID of the file does not match the effective group ID of the process or 
one of the supplementary group IDs of the process, the mode bit set 
group ID on executionis cleared (see chmod(2)). Clearing this bit 
may disable mandatory record locking on this file. 


Upon successful completion, a write-only file descriptor is returned and the 
file is open for writing, even if the mode does not permit writing. The file 
pointer is set to the beginning of the file. The file descriptor is set to remain 
open across exec system calls (see fentl(2)). No process may have more than 
NOFILES files open simultaneously (see intro(2)). A new file may be created 
with a mode that forbids writing. 


creat fails if one or more of the following are true: 


[EACCES] Search permission is denied on a component of the path 
prefix. 

[EACCES] The file does not exist and the directory in which the file 
is to be created does not permit writing. 

[EACCES] The file exists and write permission is denied. 

[EAGAIN] The file exists, mandatory file/record locking is set, and 
there are outstanding record locks on the file (see 
chmod(2)). 

[EFAULT] path points outside the allocated address space of the 
process. 

{EINTR) Asignal was caught during the creat system call. 

[EIO] An I/O error occurred while reading from or writing to 
the file system. 
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(EISDIR] 
[ELOOP] 


[EMFILE] 

[ENAMETOOLONG] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 


[ENFILE] 

[ENOENT] 
[ENOENT] 
[ENOSPC] 


[ENOSPC] 


(ENOTDIR] 


{EROFS] 


[ETXTBSY] 


SEE ALSO 
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The named file is an existing directory. 


Too many symbolic links were encountered in translat- 
ing path. 


NOFILES file descriptors are currently open. (see 
intro(2)). 
path was longer than PATH_MAX characters. 


path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


The system file table is full. 
Acomponent of the path prefix does not exist. 
The pathname is null. 


There are no free inodes on the file system on which the 
file is being created. 


The directory in which the entry for the new file is being 
placed cannot be extended because there is no space left 
on the file system containing the directory. 


Acomponent of the path prefix is not a directory. 


The named file resides or would reside on a read-only 
filesystem. 


The file is a pure procedure (shared text) file that is 
being executed. 


chmod(2), close(2), dup(2), fentl(2), intro(2), lseek(2), open(2), read(2), 
umask(2), write(2), getdtablesize(2seq) 


DIAGNOSTICS 


Upon successful completion, a non-negative integer, namely the file descriptor, 
is returned. Otherwise, a value of —1 is returned and errno is set to indicate 


the error. 
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NAME 


2) SYNOPSIS 


dup — duplicate an open file descriptor 


int dup (fildes) 


_ int fildes; 


DESCRIPTION 


fildes is a file descriptor obtained from a creat, open, dup, fentl, or pipe 
system call. dup returns a new file descriptor having the following in com- 
mon with the original: 


Same open file (or pipe). 
Same file pointer (i.e., both file descriptors share one file pointer). 
Same access mode (read, write or read/write). 


The new file descriptor is set to remain open across exec system calls (see 
fentl(2)). 


The file descriptor returned is the lowest one available. 

dup fails if one or more of the following are true: 

(EBADF] fildes is not a valid open file descriptor. 

[EMFILE] NOFILES file descriptors are currently open. (see intro(2)). 


SEE ALSO 


close(2), creat(2), exec(2), fentl(2), intro(2), open(2), pipe(2), getdtablesize(2seq), 
lockf(3C) 


© DIAGNOSTICS 
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Upon successful completion a non-negative integer, namely the file descriptor, 
is returned. Otherwise, a value of —1 is returned and errno is set to indicate 
the error. 
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NAME 
dup2 — duplicate an open file descriptor 

SYNOPSIS 
int dup2 (fildes, fildes2) 
int fildes, fildes2; 

DESCRIPTION 
fildes is a file descriptor referring to an open file, and fildes2 is a non-nega- 
tive integer less than NOFILES (see intro(2)). dup2 causes fildes2 to refer 
to the same file as fildes. If fildes2 already referred to an open file, it is closed 


first. 
dup2 fails if any of the following are true: 
[EBADF] fildes is not a valid open file descriptor, or filedes2 is greater 
than NOFILES. 
SEE ALSO 
creat(2), close(2), exec(2), fentl(2), intro(2), open(2), pipe(2), lockf(3C) 
DIAGNOSTICS 


Upon successful completion a non-negative integer, namely the file descriptor, 
is returned. Otherwise, a value of —1 is returned and errno is set to indicate 
the error. 
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NAME 


exec: execl, execv, execle, execve, execlp, execvp — execute a file 


SYNOPSIS 


int execl (path, arg0, argl, .... argn, (char *)0) 
char *path, targ0, *argl, .... *argn; 

int execv (path, argv) 

char *path, targv[ J; 

int execle (path, arg0, argl, ..., argn, (char *)0, envp) 
char *path, *arg0, *argl, .... *argn, *envpl J; 
int execve (path, argv, envp) 

char *path, *argv[ ], *envpl J; 

int execlp (file, arg0, arg, ..., argn, (char *)0) 
char *file, *arg0, targ], ..., *argn; 

int execvp (file, argv) 

char *file, «argv[ J; 


DESCRIPTION 
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exec in all its forms transforms the calling process into a new process. The 
new process is constructed from an ordinary, executable file called the new 
process file. This file consists of a header (see a.out(4)), a text segment, and a 
data segment. The data segment contains an initialized portion and an unini- 
tialized portion (bss). There can be no return from a successful exec because 
the calling process is overlaid by the new process. 


An interpreter file begins with a line of the form #! interpreter [arg]. Up to 
one argument can be specified on the initial line and it will apply to all invoca- 
tions of the command. Additional command line arguments can be specified on 
each invocation. When an interpreter file is execed, the system loads the 
specified interpreter and gives it the name of the originally execed file as an 
argument, shifting over the rest of the arguments. 


When a C program is executed, it is called as follows: 


main (argc, argv, envp) 
int argc; 
char **argv, **envp; 
where argc is the argument count, argv is an array of character pointers to 
the arguments themselves, and envp is an array of character pointers to the 
environment strings. As indicated, argc is conventionally at least one and the 
first member of the array points to a string containing the name of the file. 


path points to a path name that identifies the new process file. 


file points to the new process file. The path prefix for this file is obtained by a 
search of the directories passed as the environment line "PATH =" (see envi- 
ron(5)). The environment is supplied by the shell (see sh(1)). 


arg0, arg], .... argn are pointers to null-terminated character strings. These 
strings constitute the argument list available to the new process. By conven- 
tion, at least arg0 must be present and point to a string that is the same as 
path (or its last component). 
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Argv is an array of character pointers to null-terminated strings. These 
strings constitute the argument list available to the new process. By conven- 
tion, argv must have at least one member, and it must point to a string that 
is the same as path (or its last component). argv is terminated by a null 
pointer. 


emvp is an array of character pointers to null-terminated strings. These 
strings constitute the environment for the new process. envp is terminated 
by a null pointer. For execl and execv, the C run-time start-off routine 
places a pointer to the environment of the calling process in the global cell: 


extern char **environ; 


and it is used to pass the environment of the calling process to the new pro- 
cess. 


File descriptors open in the calling process remain open in the new process, 
except for those whose close-on-exec flag is set; see fent](2). For those file 
descriptors that remain open, the file pointer is unchanged. 


Signals set to terminate the calling process will be set to terminate the new 
process. Signals set to be ignored by the calling process will be set to be 
ignored by the new process. Signals set to be caught by the calling process 
will be set to terminate the new process; see signal(2). 


For signals set by sigset(2), exec will ensure that the new process has the 
same system signal action for each signal type whose action is SIG_DFL, 
SIG_IGN, or SIG_HOLD as the calling process. However, if the action is to 
catch the signal, then the action will be reset to SIG_DFL, and any pending 
signal for this type will be held. 


If the set-user-ID mode bit of the new process file is set (see chmod(2)), exec 
sets the effective user ID of the new process to the owner ID of the new process 
file. Similarly, if the set-group-ID mode bit of the new process file is set, the 
effective group ID of the new process is set to the group ID of the new process 
file. If the new process file is an interpreter file, that is, it begins with a #/, 
the effective user and group IDs remain unchanged. This effectively disallows 
setuid shell scripts. The real user ID and real group ID of the new process, as 
well as the supplementary group ID, remain the same as those of the calling 
process. 


Shared memory segments and mapped segments attached to the calling pro- 
cess will not be attached to the new process (see shmop(2) and mmap(2seq)). 


Profiling is disabled for the new process; see profil(2). 
The new process also inherits the following attributes from the calling process: 
nice value (see nice(2)) 
process ID 
parent process ID 
process group ID 
session ID 
semadj values (see semop(2)) 
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foreground process ID (see exit(2) and signal(2)) 
trace flag (see ptrace(2) request 0) 

time left until an alarm clock signal (see alarm(2)) 
current working directory 


root directory 


file mode creation mask (see umask(2)) 
file size limit (see ulimit(2)) 
utime, stime, cutime, and cstime (see times(2)) 
file-locks (see fentl(2) and lockf(3C)) 
affinity (see tmp_affinity(2)) 
exec fails and returns to the calling process if one or more of the following are 


true: 
[EACCES] 


[EACCES] 
[EACCES] 
[EAGAIN] 


[EFAULT] 
[EIO] 


[ELOOP] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 
(ENAMETOOLONG] 
[ENOENT] 


[ENOEXEC] 


[ENOMEM] 
[ENOTDIR] 


(ETXTBSY] 


Search permission is denied for a directory listed in the 
new process file’s path prefix. 


The new process file is not an ordinary file. 
The new process file mode denies execution permission. 


The memory required to execute the new image exceeds 
the available space in the swap area. 


path, argv, or envp point to an illegal address. 

An V/O error occurred while reading from or writing to 
the file system. 

Too many symbolic links were encountered in translat- 
ing path. 

path is longer than PATH_MAX characters. 


path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 

One or more components of the new process path name 
of the file do not exist. 


The exec is not an execlp or execvp, and the new pro- 
cess file has the appropriate access permission but an 
invalid magic number in its header. 


The new process requires more memory than is allowed 
by the system-imposed maximum. 

Acomponent of the new process path of the file prefix is 
not a directory. 

The new process file is a pure procedure (shared text) 
file that is currently open for writing by some process. 
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(E2BIG] The number of bytes in the new process's argument list 
is greater than the system-imposed limit of ARG_MAX 
bytes. 

SEE ALSO 


sh(1), alarm(2), exit(2), fentl(2), fork(2), nice(2), ptrace(2), semop(2), signal(2), 
sigset(2), times(2), ulimit(2), umask(2), lockf(3C), a.out(4), environ(5) 


DIAGNOSTICS 
If exec returns to the calling process an error has occurred; the return value 
is —1 and errno is set to indicate the error. 
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NAME 
@ exit, _exit — terminate process 

SYNOPSIS 
void exit (status) 
int status; 
void _exit (status) 
int status; 

DESCRIPTION 
exit terminates the calling process with the following consequences: 


All of the file descriptors open in the calling process are closed. 


If the parent process of the calling process is executing a wait, it is 
notified of the calling process’s termination and the low order eight 
bits (i.e., bits 0377) of status are made available to it [see wait(2)]. 


If the parent process of the calling process is not executing a wait, the 
calling process is transformed into a zombie process. A zombie process 
is a process that only occupies a slot in the process table. It has no 
other space allocated either in user or kernel space. The process table 
slot that it occupies is partially overlaid with time accounting informa- 
tion (see <sys /proc.h>) to be used by times and get_pro- 
cess_stats(2). 

The parent process ID of all of the calling processes’ existing child processes 

and zombie processes is set to 1. This means the initialization process [see 

intro(2)] inherits each of these processes. 

& Each attached shared memory segment is detached and the value of 
shm_nattach in the data structure associated with its shared memory iden- 
tifier is decremented by 1. 


All mapped regions (see mmap(2seq)) are detached from the process. 


For each semaphore for which the calling process has set a semadj value (see 
semop(2)), that semadj value is added to the semval of the specified sema- 
phore. 

If the process has a process, text, or data lock, an unlock is performed (see 
plock(2)). 

An accounting record is written on the accounting file if the system’s account- 
ing routine is enabled (see acct(2)). 

If the process is the controlling process (session leader with a controlling ter- 
minal), then SIGHUP signal is sent to each process in the current foreground 
process group. 

A death-of-child signal is sent to the parent. 

The C function exit may cause cleanup actions before the process exits. The 
function _exit circumvents all cleanup. 


SEE ALSO 
acct(2), intro(2), plock(2), semop(2), signal(2), sigset(2), sigaction(2seq), wait(2), 


@ get_process_stats(2) 
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WARNING 
See WARNING in signal(2) 


DIAGNOSTICS 
None. There can be no return from an exit system call. 
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FCNTL(2) 


fentl — file control 


#include <fentlh> 
int fentl (fildes, cmd, arg) 
int fildes, cmd, arg; 


DESCRIPTION 
fentl provides for contro] over open files. fildes is an open file descriptor 
obtained from a creat, open, dup, fentl, or pipe system call. 


The commands available are: 


F_DUPFD 


F_GETFD 


F_GETFL 
F_GETLK 


F_SETFD 


F_SETFL 


F_SETLK 


F_SETLKW 


Return a new file descriptor as follows: 

Lowest numbered available file descriptor greater than or 
equal to arg. 

Same open file (or pipe) as the original file. 


Same file pointer as the original file (i.e., both file descriptors 
share one file pointer). 


Same access mode (read, write or read/write). 


Same file status flags (i.e., both file descriptors share the 
same file status flags). 


The close-on-exec flag associated with the new file descriptor 
is set to remain open across exec(2) system calls. 


Get the close-on-exec flag associated with the file descriptor 
fildes. If the low-order bit is 0, the file remains open across 
exec, otherwise the file is closed upon execution of exec. 


Get file status flags. 


Get the first lock which blocks the lock description given by 
the variable of type struct flock pointed to by arg. The 
information retrieved overwrites the information passed to 
fentlin struct flock. Ifno lock is found that would pre- 
vent this lock from being created, then the structure is pas- 
sed back unchanged except for the lock type which is set to 
F_UNLCK. 


Set the close-on-exec flag associated with fildes to the low- 
order bit of arg (0 or 1 as above). 


Set file status flags to arg. Only certain flags can be set (see 
fentl(5)). 


Set or clear a file segment lock according to the variable of 
type struct flock pointed to by arg (see fentl(5)). The 
cmd F_SETLK is used to establish read (F_RDLCK) and write 
(F_WRLCK) locks, as well as remove either type of lock 
(F_UNLCK). Ifa read or write lock cannot be set fentl 
returns immediately with an error value of —1. 


This cmd is the same as F_SETLK except that if a read or 
write lock is blocked by other locks, the process sleeps until 
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the segment is free to be locked. 


Aread lock prevents any process from write locking the protected area. More 
than one read lock may exist for a given segment of a file at a given time. The 
file descriptor on which a read lock is being placed must have been opened 
with read access. 


A write lock prevents any process from read locking or write locking the pro- 
tected area. Only one write lock may exist for a given segment of a file ata 
given time. The file descriptor on which a write lock is being placed must have 
been opened with write access. 


The structure flock describes the type (I_type), starting offset (I_whence), 
relative offset (I_start), size (I_len), and process ID (_pid) of the segment of 
the file to be affected. The process ID and system ID fields are used only with 
the F_GETLK emd to return the values for a blocking lock. On DYNIX systems, 
l_sysid always has a value of zero. Locks may start and extend beyond the 
current end of a file, but may not be negative relative to the beginning of the 
file. A lock may be set to always extend to the end of file by setting I_len to 
zero (0). If such a lock also has L_whence and |_start set to zero (0), the 
whole file is locked. Changing or unlocking a segment from the middle of a 
larger locked segment leaves two smaller segments for either end. Locking a 
segment that is already locked by the calling process causes the old lock type 
to be removed and the new lock type to take effect. All locks associated with a 
file for a given process are removed when a file descriptor for that file is closed 
by that process or the process holding that file descriptor terminates. Locks 
are not inherited by a child process in a fork(2) system call. 


When mandatory file and record locking is active on a file, (see chmod(2)), 
read and write system calls issued on the file are affected by the record locks 
in effect. The mmap(2seq) system call fails on any file which has mandatory 
locking enabled. This is to prevent a user from using mmap to modify a file 
while a mandatory lock asserted on that file. 


fentl fails if one or more of the following are true: 


[EACCES] emd is F_SETLK the type of lock l_type is a read (F_RDLCK) 
lock and the segment of a file to be locked is already write 
locked by another process or the type is a write (F_WRLCK) 
lock and the segment of a file to be locked is already read or 
write locked by another process. 


[EBADF] fildes is not a valid open file descriptor. 


[EDEADLK] emd is F_SETLKW, the lock is blocked by some lock from 
another process, and putting the calling-process to sleep, 
waiting for that lock to become free, would cause a deadlock. 


[EFAULT] cmd is F_SETLK, arg points outside the program address 
space. 

[EINTR} Asignal was caught during the fentl system call. 

[EINVAL] emd is F_DUPFD. arg is either negative, or greater than or 


equal to ENOFILES (see getdtablesize(2) and intro(2)). 
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SEE ALSO 
close(2), creat(2), dup(2), exec(2), fork(2), intro(2), open(2), pipe(2), fentl(5), 
mmap(2seq), getdtablesize(2seq) 

DIAGNOSTICS 
Upon successful completion, the value returned depends on cmd as follows: 


12/89 


F_DUPFD 
F_GETFD 
F_GETFL 
F_GETLK 
F_SETFD 
F_SETFL 
F_SETLK 
F_SETLKW 
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cmd is F_GETLK, F_SETLK, or SETLKW and arg or the data it 
points to is not valid. 


emd is F_DUPFD and NOFILES file descriptors are currently 
open. 

emd is F_SETLK or F_SETLKW, the type of lock is a read or 
write lock, and there are no more record locks available (too 


many file segments locked) because the system maximum has 
been exceeded. 


A new file descriptor 

Value of flag (only the low-order bit is defined) 
Value of file flags 

Value other than —1 

Value other than —1 

Value other than —1 

Value other than —1 

Value other than —1 


Otherwise, a value of —1 is returned and errno is set to indicate the error. 


WARNINGS 
Because in the future the variable errno is set to EAGAIN rather than 
EACCES when a section of a file is already locked by another process, portable 
application programs should expect and test for either value. 
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NAME 
fork — create a new process 


SYNOPSIS 
#include <sys/types.h> 
pid_t fork () 


DESCRIPTION 
fork causes creation of a new process. The new process (child process) is an 
exact copy of the calling process (parent process). This means the child pro- 
cess inherits the following attributes from the parent process: 


environment 
close-on-exec flag (see exec(2)) 


signal handling settings (i.e., SIG_DFL , SIG_IGN , SIG_HOLD , function 
address) 


set-user-ID mode bit 
set-group-ID mode bit 
profiling on/off status 
nice value (see nice(2)) 
all attached shared memory segments (see shmop(2)) 
all attached mapped regions (see mmap(2seq)) 
process group ID 
session ID 
foreground process ID (see exit(2)) 
current working directory 
root directory 
file mode creation mask (see umask(2)) 
file size limit (see ulimit(2)) 
The child process differs from the parent process in the following ways: 
The child process has a unique process ID. 


The child process has a different parent process ID (i.e., the process ID 
of the parent process). 


The child process has its own copy of the parent’s file descriptors. 
Each of the child’s file descriptors shares a common file pointer with 
the corresponding file descriptor of the parent. 


All semadj values are cleared (see semop(2)). 


Process locks, text locks and data locks are not inherited by the child 
(see plock(2)). 

The child process’s utime, stime, cutime, and cstime are set to 0. 
The time left until an alarm clock signal is reset to 0. 


fork fails and no child process is created if one or more of the following are 
true: 
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[EAGAIN] The system-imposed limit on the total number of processes 
under execution would be exceeded. 
[EAGAIN] The system-imposed limit on the total number of processes 


under execution by a single user would be exceeded. 
_ [ENOMEM] There is insufficient swap space available for the process. 


SEE ALSO 
exec(2), nice(2), plock(2), ptrace(2), semop(2), shmop(2), signal(2), sigset(2), 
sigaction(2), times(2), ulimit(2), umask(2), wait(2) 

DIAGNOSTICS 
Upon successful completion, fork returns a value of 0 to the child process and 
returns the process ID of the child process to the parent process. Otherwise, a 
value of -1 is returned to the parent process, no child process is created, and 
errno is set to indicate the error. 
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NAME 


@ SYNOPSIS 


getdents — read directory entries and put in a file system independent format 


#include <sys/dirent.h> 


int getdents (fildes, buf, nbyte) 
int fildes; 

char *buf; 

unsigned nbyte; 


DESCRIPTION 


fildes is a file descriptor obtained from an open(2) or dup(2) system call. 
getdents attempts to read nbyte bytes from the directory associated with 
fildes and to format them as file system independent directory entries in the 
buffer pointed to by buf. Since the filesystem independent directory entries 
are of variable length, in most cases the actual number of bytes returned will 
be strictly less than nbyte. 

The filesystem independent directory entry is specified by the dirent struc- 
ture. For a description of this see dirent(4). 

On devices capable of seeking, getdents starts at a position in the file given 
by the file pointer associated with fildes. Upon return from getdents, the file 
pointer is incremented to point to the next directory entry. 


This system cal] was developed in order to implement the readdir(3X) routine 
[for a description see directory(3X)], and should not be used for other pur- 
poses. 

getdents will fail if one or more of the following are true: 


[EBADF] fildes is not a valid file descriptor open for reading. 

(EFAULT] buf points outside the allocated address space. 

[EINVAL] nbyte is not large enough for one directory entry. 

(EIO] An I/O error occurred while accessing the filesystem. 

[ENOENT] The current file pointer for the directory is not located at a 
valid entry. 


[ENOTDIR] fildes is not a directory. 


SEE ALSO 


directory(3X), dirent(4) 


DIAGNOSTICS 
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Upon successful completion a non-negative integer is returned indicating the 
number of bytes actually read. A value of 0 indicates the end of the directory 
has been reached. If the system call failed, a -1 is returned and errno is set 
to indicate the error. 


DYNIX/ptx GETGROUPS(2) 


NAME 


getgroups — get supplementary group IDs 


SYNOPSIS 


#include <sys/types.h> 


. int getgroups (gidsetsize, grouplist) 


int gidsetsize; 
gid_t grouplist[]; 


DESCRIPTION 


The getgroups function fills in the array grouplist with the supplementary 
group IDs of the calling process. The gidsetsize argument specifies the num- 
ber of elements in the supplied array grouplist. The actual number of supple- 
mentary group IDs is returned. The values of array entries with indexes 
larger than or equal to the returned value are undefined. 


It is unspecified whether the effective group ID of the calling process is 
included in or omitted from the returned list of supplementary group IDs. 


As a special case, if the gidsetsize argument is zero, getgroups returns the 
number of supplementary group IDs associated with the calling process with- 
out modifying the array pointed to by the grouplist argument. 


Upon successful competion, the number of supplementary group IDs is 
returned. This value is zero if (NGROUPS-MAX) is zero. A return value of -1 
indicates failure and errno is set to indicate the error. 


If the following condition occurs, getgroups returns -1 and sets errno to the 
corresponding value: 

[EINVAL] The gidsetsize argument is not equal to zero and is less than the 
number of supplementary group IDs. 


{EFAULT] The grouplist argument points outside the allocated address space 
for the process. 


SEE ALSO 
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setuid(2) 


DYNIX/ptx GETMSG(2) 


NAME 


o SYNOPSIS 


getmsg — get next message off a stream 


#include <stropts.h> 


int getmsg(fd, ctlptr, dataptr, flags) 
int fd; 

struct strbuf *ctlptr; 

struct strbuf *dataptr; 

int *flags; 


DESCRIPTION 
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getmeg retrieves the contents of a message (see intro(2)) located at the 
stream head read queue from a STREAMS file, and places the contents into 
user specified buffer(s). The message must contain either a data part, a con- 
trol part or both. The data and control parts of the message are placed into 
separate buffers, as described below. The semantics of each part is defined by 
the STREAMS module that generated the message. 


fd specifies a file descriptor referencing an open stream. ctlptr and dataptr 
each point to a strbuf structure which contains the following members: 

int maxlen; /* maximum buffer length */ 

int len; /* length of data ay 

char *buf; /* ptr to buffer */ 
where buf points to a buffer in which the data or control information is to be 
placed, and maxlen indicates the maximum number of bytes this buffer can 
hold. On return, len contains the number of bytes of data or control informa- 
tion actually received, or is 0 if there is a zero-length control or data part, or is 
-1 if no data or control information is present in the message. flags may be 
set to the values 0 or RS_HIPRI and is used as described below. 


ctlptr is used to hold the control part from the message and dataptr is used 
to hold the data part from the message. If ctlptr (or dataptr) is NULL or the 
maxlen field is -1, the control (or data) part of the message is not processed 
and is left on the stream head read queue and len is set to -1. If the maxlen 
field is set to 0 and there is a zero-length control (or data) part, that zero- 
length part is removed from the read queue and len is set to 0. If the maxlen 
field is set to 0 and there are more than zero bytes of control (or data) informa- 
tion, that information is left on the read queue and len is set to 0. If the max- 
len field in ctlptr or dataptr is less than, respectively, the control or data 
part of the message, maxlen bytes are retrieved. In this case, the remainder 
of the message is left on the stream head read queue and a non-zero return 
value is provided, as described below under DIAGNOSTICS. If information is 
retrieved from a high-priority message, flags is set to RS_HIPRI on return. 


By default, getmsg processes the first priority or non-priority message avail- 
able on the stream head read queue. However, a user may choose to retrieve 
only priority messages by setting flags to RS_HIPRI. In this case, getmsg will 
only process the next message if it is a priority message. 


If O_NDELAY has not been set, getmsg blocks until a message, of the type(s) 
specified by flags (priority or either), is available on the stream head read 
queue. If O_NDELAY has been set and a message of the specified type(s) is not 
present on the read queue, getmeg fails and sets errno to EAGAIN. 
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if a hangup occurs on the stream from which messages are to be retrieved, 


getmeg will continue to operate normally, as described above, until the 

stream head read queue is empty. Thereafter, it will return 0 in the len fields 

of ctlptr and dataptr. 

getmeg fails if one or more of the following are true: 

[EAGAIN] The O_NDELAY flag is set, and no messages are available. 

(EBADF] fd is not a valid file descriptor open for reading. 

[EBADMSG] Queued message to be read is not valid for getmsg. 

[EFAULT] ctlptr, dataptr, or flags points to a location outside the allo- 
cated address space. 

[EINTR] Asignal was caught during the getmsg system call. 

[EINVAL] An illegal value was specified in flags, or the stream refer- 
enced by fd is linked under a multiplexor. 

[ENOSTR] Astream is not associated with fd. 


A getmsg can alzo fail if a STREAMS error message had been received at the 
stream head before the call to getmsg. The error returned is the value con- 
tained in the STREAMS error message. 


SEE ALSO 
intro(2), read(2), poll(2), putmsg(2), write(2) 


DIAGNOSTICS 
Upon successful completion, a non-negative value is returned. A value of 0 
indicates that a full message was read successfully. A return value of 
MORECTL indicates that more control information is waiting for retrieval. A 
return value of MOREDATA indicates that more data is waiting for retrieval. 
Areturn value of MORECTL! MOREDATA indicates that both types of informa- 
tion remain. Subsequent getmsg calls will retrieve the remainder of the mes- 


sage. 
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DYNIX/ptx GETPID(2) 


NAME 
getpid, getpgrp, getppid — get process, process group, and parent process IDs 


SYNOPSIS 
#include <sys/types.h> 


pid_t getpid () 
pid_t getpgrp () 
pid_t getppid () 


DESCRIPTION 
getpid returns the process ID of the calling process. 


getpgrp returns the process group ID of the calling process. 
getppid returns the parent process ID of the calling process. 


SEE ALSO 
exec(2), fork(2), intro(2), setpgrp(2), setpgid(2), signal(2) 
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NAME 
getuid, geteuid, getgid, getegid — get real user, effective user, real group, and 
effective group IDs 


SYNOPSIS 
#include <sys/types.h> 


uid_t getuid () 
uid_t geteuid () 
gid_t getgid () 
gid_t getegid () 


DESCRIPTION 
getuid returns the real user ID of the calling process. 


geteuid returns the effective user ID of the calling process. 
getgid returns the real group ID of the calling process. 
getegid returns the effective group ID of the calling process. 


SEE ALSO 
intro(2), setuid(2) 
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DYNIX/ptx IOCTL(2) 


NAME 


& ioctl — control device 
SYNOPSIS 


int ioctl (fildes, request, arg) 
int fildes, request; 

DESCRIPTION 
ioctl performs a variety of control functions on devices and STREAMS. For 
non-STREAMS files, the functions performed by this call are device-specific con- 
trol functions. The arguments request and arg are passed to the file desig- 
nated by fildes and are interpreted by the device driver. This control is infre- 
quently used on non-STREAMS devices, with the basic input/output functions 
performed through the read(2) and write(2) system calls. 
For STREAMS files, specific functions are performed by the ioctl call as 
described in streamio(7). 
fildes is an open file descriptor that refers to a device. request selects the 
control function to be performed and will depend on the device being 
addressed. arg represents additional information that is needed by this spe- 
cific device to perform the requested function. The data type of arg depends 
upon the particular control request, but it is either an integer or a pointer toa 
device-specific data structure. 


In addition to device-specific and STREAMS functions, generic functions are 
provided by more than one device driver, for example, the general terminal 
interface (see termio(7)). 

@ ioctl fails for any type of file if one or more of the following are true: 
{EBADF] fildes is not a valid open file descriptor. 


(EFAULT] request requires a data transfer to or from a buffer pointed to by 
arg, but some part of the buffer is outside the process’s allocated 
space. , 


(EINTR] A signal was caught during the ioctl system call. 


ioctl also fails if the device driver detects an error. In this case, the error is 
passed through ioctl without change to the caller. A particular driver might 
not have all of the following error cases. Other requests to device drivers fail] 
if any of the following are true: 


(EINVAL] request or arg is not valid for this device. 


[EIO] Some physical I/O error has occurred. 
[ENOTTY]  fildes is not associated with a device driver that accepts control 
functions. 


[ENXIO] The request and arg are valid for this device driver, but the ser- 
vice requested can not be performed on this particular subdevice. 


STREAMS errors are described in streamio(7). 


SEE ALSO 
streamio(7), termio(7) 
i) DIAGNOSTICS 
Upon successful completion, the value returned depends upon the device 
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control function, but must be a non-negative integer. Otherwise, a value of —1 
is returned and errno is set to indicate the error. @ 


2 12/89 


DYNIX/ptx KILL(2) 


NAME 
2 kill — send a signal to a process or a group of processes 

SYNOPSIS 
int kill (pid, sig) 
int pid, sig; 

DESCRIPTION 
kill sends a signal to a process or a group of processes. The process or group 
of processes to which the signal is to be sent is specified by pid. The signal 
that is to be sent is specified by sig and is either one from the list given in sig- 
nal(2), or 0. If sig is 0 (the null signal), error checking is performed but no 
signal is actually sent. This can be used to check the validity of pid. 


The real or effective user ID of the sending process must match the real or 
effective user ID of the receiving process, unless the effective user ID of the 
sending process is superuser. 


Certain processes are exempt form system wide signals and are know as "Sys- 
tem processes.” These are: 


init - system initialization process 

sched - swapper daemon process 

vhand - pageout daemon process 

bdflush - disk block delayed flush daemon process 


If pid is greater than zero, sig will be sent to the process whose process ID is 
e equal to pid. pid may equal 1. 

If pid is 0, sig will be sent to all processes excluding System Processes whose 

process group ID is equal to the process group ID of the sender. 

If pid is —1 and the effective user ID of the sender is not superuser, sig will be 


sent to all processes excluding System Processes whose real user ID is equal to 
the effective user ID of the sender. 


If pid is —1 and the effective user ID of the sender is superuser, sig will be 
sent to all processes excluding System Processes. 


If pid is negative but not —1, sig will be sent to all processes whose process 
group ID is equal to the absolute value of pid. 


kill will fail and no signal will be sent if one or more of the following are true: 


[EINVAL] Sig is not a valid signal number. 
[EINVAL] sig is SIGKILL and pid is 1 (proc}). 
{[EPERM] The user ID of the sending process is not superuser, and its 


real or effective user ID does not match the real or effective 
user ID of the receiving process. 


[ESRCH] No process can be found corresponding to that specified by 
pid. 


SEE ALSO 
& {cill(1), getpid(2), setpgrp(2), signal(2), sigset(2) 
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DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


© SYNOPSIS 
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link - link to a file 


LINK(2) 


int link (path1, path2) 
char *pathl, *path2; 
DESCRIPTION 
path! points to a pathname naming an existing file. path2 points to a path- 
name naming the new directory entry to be created. link creates a new link 
(directory entry) for the existing file. 


link will fail and no link is created if one or more of the following are true: 


[EACCES] 


[EACCES] 


(EEXIST] 
[EFAULT] 


[EIO} 


[ELOOP] 


[EMLINK] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


[ENOENT] 
[ENOENT] 
[ENOENT] 
[ENOSPC] 


(ENOTDIR] 


(EPERM] 


[EROFS] 


[EXDEV] 


Acomponent of either path prefix denies search permis- 
sion. 


The requested link requires writing in a directory with a 
mode that denies write permission. 
The link named by path2 exists. 


path1 or path2 points outside the allocated address 
space of the process. 


An I/O error occurred while reading from or writing to 
the file system. 


Too many symbolic links were encountered in translat- 
ing pathlor path2. 


The maximum number of links to a file would be 
exceeded. 


path] or path2 was longer than PATH_MAX characters. 


path1or path2 referenced a symbolic link which, when 
expanded, resulted in a path name longer than 
PATH_MAX characters. 


Acomponent of path1 or path2 was longer than 
NAME_MAX characters. 


Acomponent of either path prefix does not exist. 
The file named by path] does not exist. 
path2 points to a null pathname. 


The directory in which the entry for path2 is being 
placed cannot be extended because there is no space left 
on the file system containing the directory. 


Acomponent of either path prefix is not a directory. 


The file named by path1 is a directory and the effective 
user ID is not superuser. 

The requested link requires writing in a directory on a 
read-only filesystem. 

The link named by path2 and the file named by path1 
are on different logical devices (filesystems). 
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SEE ALSO 

symlink(2), unlink(2) © 
DIAGNOSTICS 

Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 

is returned and errno is set to indicate the error. 
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DYNIX/ptx LSEEK(2) 


NAME 
& lseek — move read/write file pointer 


SYNOPSIS 
#include <sys/types.h> 
#include <unistd.h> 


off_t lseek (fildes, offset, whence) 
int fildes; 
off_t offset; 
int whence; 
DESCRIPTION 
fildes is a file descriptor returned from a creat, open, dup, or fcent] system 
call. Iseek sets the file pointer associated with fildes as follows: 


If whence is SEEK_SET, the pointer is set to offset bytes. 


If whence is SEEK_CUR, the pointer is set to its current location plus 
offset. 


If whence is SEEK_END, the pointer is set to the size of the file plus 
offset. 


Upon successful completion, the resulting pointer location, as measured in 
bytes from the beginning of the file, is returned. 


Seeking far beyond the end of a file, then writing, creates a gap or “hole”, 
which occupies no physical file system space and reads as zeros. 


& Iseek fails and the file pointer is unchanged if any of the following are true: 
(EBADF] fildes is not an open file descriptor. 
[EINVAL and SIGSYS signal] 
whence is not one of SEEK_SET, SEEK_CUR or SEEK_END. 
[EINVAL] The resulting file pointer would be negative. 
(ESPIPE] fildes is associated with a pipe or fifo. 


Some devices are incapable of seeking. The value of the file pointer associated 
with such a device is undefined. 


SEE ALSO 
creat(2), dup(2), fentl(2), open(2) 


DIAGNOSTICS 
Upon successful completion, a non-negative integer indicating the file pointer 
value is returned. Otherwise, a value of —1 is returned and errno is set to 
indicate the error. 
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DYNIX/ptx MKDIR(2) 


NAME 


mkdir — make a directory 


SYNOPSIS 


#include <sys/types.h> 
int mkdir (path, mode) 
char *path; 

mode_t mode; 


DESCRIPTION 
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The routine mkdir creates a new directory with the name path. The mode of 
the new directory is initialized from the mode. The protection part of the 
mode argument is modified by the process’s mode mask [see umask(2)]. 


The directory’s owner ID is set to the process’s effective user ID. The direc- 
tory’s group ID is set to the group ID of the directory in which this directory is 
being created. The newly created directory is empty with the possible excep- 


tion of entries for"." and"..". mkdir fails and no directory is created if any of 
the following are true: 


(EACCES] Either a component of the path prefix denies search per- 
mission or write permission is denied on the parent 
directory of the directory to be created. 


(EEXIST] The named file already exists. 

[EFAULT] path points outside the allocated address space of the 
process. 

(EIO] An V/0 error has occurred while accessing the filesystem. 

{EIO] An I/O error occurred while reading from or writing to 
the file system. 

[ELOOP] Too many symbolic links were encountered in translat- 
ing path. 

(EMLINK] The maximum number of links to the parent directory 
would be exceeded. 


[ENAMETOOLONG] The path is longer than PATH_MAX characters. 


[ENAMETOOLONG] _ path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 


ters. 

[ENAMETOOLONG] Acomponent of path was longer than NAME_MAX char- 
acters. 

[ENOENT] Acomponent of the path prefix does not exist. 

[ENOSPC] The directory in which the entry for the new directory is 


being placed cannot be expanded because there is no 
space left on the file system containing the directory. 


[ENOSPC] The new directory cannot be created because there is no 
space left on the file system which will contain the direc- 
tory. 

[ENOSPC] There are no free inodes on the file system on which the 
directory is being created. 
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(ENOTDIR] Acomponent of the path prefix is not a directory. 
[EROFS] The path prefix resides on a read-only filesystem. © 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned, and errno is set to indicate the error. 


SEE ALSO 
umask(2), chmod(2), stat(2), Istat(2) 
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DYNIX/ptx MKNOD(2) 


NAME 


© SYNOPSIS 


mknod — make a directory, or.a special or ordinary file 


int mknod (path, mode, dev) 
char *path; 
mode_t mode; 
dev_t dev 


DESCRIPTION 
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mknod creates a new file named by the pathname pointed to by path. The 
mode of the new file is initialized from mode, where the value of mode is 
interpreted as follows: 


0170000 file type; one of the following: 
0010000 fifo special 
0020000 character special 
0040000 directory 
0060000 block special 
0100000 or 0000000 ordinary file 


0004000 set user ID on execution 


00020#0 set group ID on execution if # is 7, 5, 3, or 1 
enable mandatory file/record locking if # is 6, 4, 2, or 0 


0001000 save text image after execution 


0000777 access permissions; constructed from the following: 
0000400 read by owner 
0000200 write by owner 
0000100 execute (search on directory) by owner 
0000070 read, write, execute (search) by group 
0000007 read, write, execute (search) by others 


The owner ID of the file is set to the effective user ID of the process. The group 


ID of the file is set to the group ID of the directory in which the file is being 
created. 


Values of mode other than those above are undefined and should not be used. 
The low-order 9 bits of mode are modified by the process’s file mode creation 
mask: all bits set in the process's file mode creation mask are cleared (see 
umask(2)). If mode indicates a block or character special file, dev is a confi- 
guration-dependent specification of a character or block I/O device. If mode 
does not indicate a block special or character special device, dev is ignored. 


mknod may be invoked only by the superuser for file types other than FIFO 
special. 


mknod fails and the new file is not created if any of the following are true: 


[EACCESS] Acomponent of path denied search permission for the 
creation of a fifo by a non superuser. 

(EEXIST] The named file exists. 

(EFAULT] path points outside the allocated address space of the 
process. 
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[EIO] 


([EISDIR) 
[ELOOP] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


[ENOENT] 


[ENOSPC] 


[ENOSPC] 


[ENOSPC] 


[ENOTDIR} 
[EPERM] 
[EROFS] 


SEE ALSO 
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An V/O error occurred while reading from or writing to 
the file system. 


path is a directory. 

Too many symbolic links were encountered in translat- 
ing path. 

path was longer than PATH_MAX characters. 


path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


Acomponent of the path prefix does not exist. 


The directory in which the entry for the new file is being 
placed cannot be expanded because there is no space left 
on the file system containing the directory. 


The new file cannot be created because there is no space 
left on the file system which will contain the file. 


There are no free inodes on the file system on which the 
file is being created. 


Acomponent of the path prefix is not a directory. 
The effective user ID of the process is not superuser. 


The directory in which the file is to be created is located 
on a read-only filesystem. 


mkdir(1), chmod(2), exec(2), umask(2), fs(4) 


DIAGNOSTICS 


Upon successful completion a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


mount — mount a filesystem 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/mount.h> 


int mount (spec, dir, mflag, fstyp, dataptr, datalen) 
char *spec, *dir; 

int mflag, fstyp; 

char *dataptr; 

int datalen; 


DESCRIPTION 
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mount requests that a removable filesystem contained on the block special 
file identified by spec be mounted on the directory identified by dir. spec 
and dir are pointers to pathnames. fstyp is the filesystem type number. The 
filesystem type number can be determined from <sys/mount.h>. Note that if 
both the MS_DATA and MS_FSS flag bits of mflag are off, the filesystem type 
defaults to the root filesystem type. Only if either flag is on is fstyp used to 
indicate the filesystem type. 


If the MS_DATA flag is set in mflag the system expects the dataptr and 
datalen arguments to be present. Together they describe a block of file-sys- 
tem specific data at address dataptr of length datalen. This is interpreted by 
file-system specific code within the operating system and its format depends 
upon the filesystem type. A particular filesystem type may not require this 
data, in which case dataptr and datalen should both be zero. Note that 
MS_FSS is obsolete and is ignored if MS_DATA is also set, but if MS_FSS is set 
and MS_DATA is not, dataptr and datalen are both assumed to be zero. 


Upon successful completion, references to the file dir refer to the root direc- 
tory on the mounted filesystem. 

The low-order bit of mflag is used to control write permission on the mounted 
filesystem; if 1, writing is forbidden, otherwise writing is permitted according 
to individual file accessibility. 

mount may be invoked only by the superuser. It is intended for use only by 
the mount(1M) utility. 


mount fails if one or more of the following are true: 


(EBUSY] dir is currently mounted on, is someone’s current work- 
ing directory, or is otherwise busy. 

[EBUSY] The device associated with spec is currently mounted. 

[EBUSY] There are no more mount table entries. 

[EFAULT] spec or dir points outside the allocated address space of 
the process. 

[EINVAL] The super block has an invalid magic number or the 
fstyp is invalid or mflag is not valid. 

[ELOOP] Too many symbolic links were encountered in translat- 


ing spec or dir. 


MOUNT(2) 
(EMULTIHOP] 


[ENAMETOOLONG] 
[ENAMETOOLONG] 


[ENAMETOOLONG] 


[ENOENT] 
{ENOLINK] 


[ENOSPC] 


[ENOTBLK} 
[ENOTDIR} 
(ENOTDIR] 
[ENXIO] 
[EPERM] 
[EREMOTE] 
(EROFS] 


SEE ALSO 
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Components of path require hopping to multiple remote 
machines. 


spec or dir was longer than PATH_MAX characters. 


spec or dir referenced a symbolic link which, when 
expanded, resulted in a path name longer than 
PATH_MAX characters. 


Acomponent of spec or dir was longer than NAME_MAX 
characters. 


Any of the named files does not exist. 


path points to a remote machine and the link to that 
machine is no longer active. 


The filesystem state in the superblock is not FsOKAY 
and mflag requests write permission. 


spec is not a block special device. 
Acomponent of a path prefix is not a directory. 
dir is not a directory. 

The device associated with spec does not exist. 
The effective user ID is not superuser. 

spec is remote and cannot be mounted. 


spec is write protected and mflag requests write per- 
mission. 


umount(2), mount(1M), fs(4) 


DIAGNOSTICS 


Upon successful completion a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


12/89 


_ DYNIX/ptx 


NAME 


& SYNOPSIS 
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MSGCTL(2) 


msgctl — message control operations 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 

int msgctl (msqid, cmd, buf) 
int msqid, cmd; 

struct msqid_ds *buf; 
DESCRIPTION 
msgctl provides a variety of message control operations as specified by cmd. 
The following cmds are available: 


IPC_STAT 


IPC_SET 


IPC_RMID 


Place the current value of each member of the data structure 
associated with msqid into the structure pointed to by buf. 
The contents of this structure are defined in intro(2). (READ) 


Set the value of the following members of the data structure 
associated with msqid to the corresponding value found in 
the structure pointed to by buf: 

msg_perm.uid 

msg_perm.gid 

msg_perm.mode /* only low 9 bits */ 

msg_qbytes 


This cmd can only be executed by a process that has an effec- 
tive user ID equal to either that of super user, or to the value 
of msg_perm.cuid or msg_perm.uid in the data structure 
associated with msqid. Only super user can raise the value 
of msg_qbytes. 

Remove the message queue identifier specified by msqid from 
the system and destroy the message queue and data structure 
associated with it. This cmd can only be executed by a pro- 
cess that has an effective user ID equal to either that of super 
user, or to the value of msg_perm.cuid or msg_perm.uid in 
the data structure associated with msqid. 


masgetl fails if any of the following are true: 


[EACCES] 


[EFAULT] 
[EINVAL] 
[EINVAL] 
[EPERM] 


[EPERM] 


cmd is equal to IPC_STAT and {READ) operation permission is 
denied to the calling process (see intro(2)). 

buf points to an illegal address. 

msqid is not a valid message queue identifier. 

emd is not a valid command. 


cmd is equal to IPC_RMID or IPC_SET. The effective user ID of 
the calling process is not equal to that of super user, or to the 
value of msg_perm.cuid or msg_perm.uid in the data struc- 
ture associated with msqid. 


cmd is equal to IPC_SET, an attempt is being made to increase to 
the value of msg_qbytes, and the effective user ID of the calling 
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process is not equal to that of super user. 


SEE ALSO @ 
intro(2), msgget(2), msgop(2) 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 
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NAME 
Msgget — get message queue 


SYNOPSIS 

#include <sys/types.h> 

#include <sys/ipc.h> 

#include <sys/msg.h> 

int msgget (key, msgfig) 

key_t key; 

int msgfig; 

DESCRIPTION 

msgget returns the message queue identifier associated with key. 

A message queue identifier and associated message queue and data structure 

(see intro(2)) are created for key if one of the following are true: 
key is equal to IPC_PRIVATE . 
key does not already have a message queue identifier associated with 
it, and (msgflg & IPC_CREAT) is true. 

Upon creation, the data structure associated with the new message queue 

identifier is initialized as follows: 
msg_perm.cuid, msg_perm.uid, msg_perm.cgid, and 
msg_perm.gid are set equal to the effective user ID and effective 
group ID, respectively, of the calling process. 
The low-order 9 bits of msg_perm.mode are set equal to the low- 
order 9 bits of msgfig. 
msg_qnum, msg_Ispid, msg_Irpid, msg_stime, and msg_rtime are 
set equal to 0. 


msg_ctime is set equal to the current time. 
msg_qbytes is set equal to the system limit. 
megget fails if any of the following are true: 


[EACCES] A message queue identifier exists for key, but operation permis- 
sion (see intro(2)) as specified by the low-order 9 bits of msgflg 
would not be granted. 


(EEXIST] A message queue identifier exists for key but ((msgfig & 
IPC_CREAT) & (msgfig & IPC_EXCL)) is true. 

([ENOENT] A message queue identifier does not exist for key and (msgflg & 
IPC_CREAT) is false. 


[ENOSPC] A message queue identifier is to be created but the system- 
imposed limit on the maximum number of allowed message queue 
identifiers system-wide would be exceeded. 


SEE ALSO 
intro(2), msgctl(2), msgop(2) 


DIAGNOSTICS 
@ Upon successful completion, a non-negative integer, namely a message queue 
identifier, is returned. Otherwise, —1 is returned and errno is set. 
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NAME 


msgop — message operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/msg.h> 


int msgsnd (msqid, msgp, msgsz, msgflg) 

int msqid; 

struct msgbuf «msgp; 

int msgsz, msgfig; 

int msgrev (msqid, msgp, msgsz, msgtyp, msgfig) 
int msqid; 

struct msgbuf *msgp; 

int msgsz; 

long msgtyp; 

int msgfig; 


DESCRIPTION 
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msgsnd is used to send a message to the queue associated with the message 
queue identifier specified by msqid. (WRITE) msgp points to a structure con- 
taining the message. This structure is composed of the following members: 
long mtype; /* message type */ 
char mtext[]; /* message text */ 
mtype is a positive integer that can be used by the receiving process for mes- 
sage selection (see mtext is any text of length msgsz bytes. msgsz can range 
from 0 to a system-imposed maximum. 
msgfig specifies the action to be taken if one or more of the following are true: 


The number of bytes already on the queue is equal to msg_qbytes 
[see intro(2)]. 
The total number of messages on all queues system-wide is equal to 
the system-imposed limit. 
These actions are as follows: 
If (msgflg & IPC_NOWAIT) is true, the message is not sent and the cal- 
ling process returns immediately. 
If (msgfig & IPC_NOWAIT) is false, the calling process suspends execu- 
tion until one of the following occurs: 
The condition responsible for the suspension no longer exists, 
in which case the message is sent. 
meqid is removed from the system (see msgetl(2)). When 
this occurs, errno is set equal to EIDRM, and a value of -1 is 
returned. 
The calling process receives a signal that is to be caught. In 


this case the message is not sent and the calling process resu- 
mes execution in the manner prescribed in signal(2). 
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megsnd fails and no message is sent if one or more of the following are true: 


[EACCES] Operation permission is denied to the calling process [see @ 
intro(2)]. 

[EAGAIN] The message cannot be sent for one of the reasons cited above 
and (msgfig & IPC_NOWAIT) is true. 

(EFAULT] msgp points to an illegal address. 

(EIDRM] The message queue associated with msgquid was deleted 


while the process was blocked in msgsnd waiting to send a 
message or while blocked in msgrev waiting to receive a mes- 


sage. 

[EINTR] A signal was caught during the msgsnd or msgrev system 
call. 

[EINVAL] msqid is not a valid message queue identifier. 

[EINVAL] mtype is less than 1. 

[EINVAL] msgsz is less than zero or greater than the system-imposed 
limit. 


Upon successful completion, the following actions are taken with respect to 
the data structure associated with msqid (see intro(2)). 


msg_qnum is incremented by 1. 
msg_lIspid is set equal to the process ID of the calling process. 
msg_stime is set equal to the current time. 


megrcv reads a message from the queue associated with the message queue 
identifier specified by msqid and places it in the structure pointed to by 
megp. {READ} This structure is composed of the following members: 

long mtype; /* message type */ 

char mtext(]; /* message text */ 
mtype is the received message’s type as specified by the sending process. 
mtext is the text of the message. msgsz specifies the size in bytes of mtext. 
The received message is truncated to msgsz " bytes" if it is larger than msgsz 
and (msgflg & MSG_NOERROR) is true. The truncated part of the message is 
lost and no indication of the truncation is given to the calling process. 


msgtyp specifies the type of message requested as follows: 
If msgtyp is equal to 0, the first message on the queue is received. 


If msgtyp is greater than 0, the first message of type msgtyp is 
received. 


If msgtyp is less than 0, the first message of the lowest type that is 

less than or equal to the absolute value of msgtyp is received. 
msgfig specifies the action to be taken if a message of the desired type is not 
on the queue. These are as follows: 


If (msgfig & IPC_NOWAIT) is true, the calling process will return 
immediately with a return value of —1 and errno set to ENOMSG. 
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If (msgflg & IPC_NOWAIT) is false, the calling process will suspend 
execution until one of the following occurs: 
A message of the desired type is placed on the queue. 
msqid is removed from the system. When this occurs, errno 
is set equal to EIDRM, and a value of —1 is returned. 


The calling process receives a signal that is to be caught. In 
this case a message is not received and the calling process 
resumes execution in the manner prescribed in signal(2). 


msgrcv fails and no message is received if one or more of the following are 
true: 


[EACCES] Operation permission is denied to the calling process. 
(EFAULT] msgp points to an illegal address. 
[EIDRM] The message queue associated with msgquid was deleted 


while the process was blocked in msgsnd waiting to send a 
message or while blocked in msgrev waiting to receive a mes- 


sage. 

[EINVAL] meqid is not a valid message queue identifier. 

(EINVAL) msgsz is less than 0. 

{E2BIG] Mtext is greater than msgsz and (msgflg & MSG_NOER- 
ROR) is false. 


[ENOMSG] The queue does not contain a message of the desired type and 
(msgtyp & IPC_NOWAIT) is true. 


Upon successful completion, the following actions are taken with respect to 
the data structure associated with msqid [see intro(2)]. 


msg_qnum is decremented by 1. 
msg_Irpid is set equal to the process ID of the calling process. 
msg_rtime is set equal to the current time. 


SEE ALSO 


intro(2), msgctl(2), msgget(2), signal(2) 


DIAGNOSTICS 
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If megsnd or msgrev return due to the receipt of a signal, a value of -1 is 
returned to the calling process and errno is set to EINTR. If they return due 
to removal of msqid from the system, a value of —1 is returned and errno is 
set to EIDRM. 


Upon successful completion, the return value is as follows: 
msgsnd returns a value of 0. 


megrcv returns a value equal to the number of bytes actually placed 
into mtext. 


Otherwise, a value of —1 is returned and errno is set to indicate the error. 
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NAME 
& nice — change priority of a process 
SYNOPSIS 
int nice (incr) 
int incr; 
DESCRIPTION 
nice adds the value of incr to the nice value of the calling process. A pro- 
cess’s nice value is a non-negative number for which a more positive value 
results in lower CPU priority. 
A maximum nice value of 39 and a minimum nice value of 0 are imposed by 
the system. (The default value is 20.) Requests for values above or below 
these limits result in the nice value being set to the corresponding limit. 
(EPERM] nice fails and does not change the nice value if iner is nega- 
tive or greater than 39 and the effective user ID of the calling 
process is not superuser. 
SEE ALSO 
nice(1), exec(2) 
DIAGNOSTICS 


Upon successful completion, nice returns the new nice value minus 20. 
Otherwise, a value of —1 is returned and errno is set to indicate the error. 
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NAME 


open — open for reading or writing 


SYNOPSIS 


#include <sys/types.h> 
#include <fentl.h> 

int open (path, oflag [, mode] 
char *path; 

int oflag; 

mode_t mode; 


DESCRIPTION 
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path points to a pathname naming a file. open opens a file descriptor for the 
named file and sets the file status flags according to the value of oflag. For 
non-STREAMS (see intro(2)) files, oflag values are constructed by ORing flags 
from the following list (only one of the first three flags below may be used): 


O_RDONLY Open for reading only. 

O_WRONLY Open for writing only. 

O_RDWR Open for reading and writing. 

O_NONBLOCK This flag may affect subsequent reads and writes (see 
read(2) and write(2)]. 
When opening a FIFO with O_RDONLY or O_WRONLY set: 
If O_NONBLOCK is set: 


An open for reading-only returns without delay. 
An open for writing-only returns an error if no 
process currently has the file open for reading. 


If O_NONBLOCK is clear: 
An open for reading-only blocks until a process 
opens the file for writing. An open for writing- 
only blocks until a process opens the file for read- 
ing. 
When opening a file associated with a communication line: 
If O_NONBLOCK is set: 
The open returns without waiting for carrier. 
If O_NONBLOCK is clear: 
The open blocks until carrier is present. 
O_NDELAY Is a synonym for O_NONBLOCK. 


O_APPEND If set, the file pointer is set to the end of the file prior to 
each write. 


O_SYNC When opening a regular file, this flag affects subsequent 
writes. If set, each write(2) waits for both the file data 
and file status to be physically updated. 


O_CREAT If the file exists, this flag has no effect. Otherwise, the 
owner ID of the file is set to the effective user ID of the pro- 
cess, the group ID of the file is set to the group ID of the 
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O_TRUNC 


O_EXCL 
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directory in which this file is being created, and the low- 
order 12 bits of the file mode are set to the value of mode 
modified as follows (see creat(2)): 


All bits set in the file mode creation mask of the 
process are cleared (see umask(2)). 


The save text image after execution bit 
of the mode is cleared (see chmod(2)). 


If the effective user ID of the process is not 
superuser and if the group ID of the file does not 
match the effective group ID of the process or one 
of the supplementary group IDs of the process, the 
mode bit set group ID on executionis 
cleared (see chmod(2)). Clearing this bit may also 
disable mandatory record locking on that file. 


If the file exists, its length is truncated to 0 and the mode 
and owner are unchanged. 


If O_EXCL and O_CREAT are set, open fails if the file 
exists. 


When opening a STREAMS file, oflag may be constructed from O_NONBLOCK 
OR-ed with either O_RDONLY, O_WRONLY or O_RDWR. Other flag values are 
not applicable to STREAMS devices and have no effect on them. The value of 
O_NONBLOCK affects the operation of STREAMS drivers and certain system 
calls (see read(2), getmsg(2), putmsg(2) and write(2)). For drivers, the 
implementation of O_NONBLOCK is device-specific. Each STREAMS device 
driver may treat this option differently. 


Certain flag values can be set following open as described in fentl(2). 


The file pointer used to mark the current position within the file is set to the 
beginning of the file. 


The new file descriptor is set to remain open across exec system calls (see 


fent](2)]. 


The named file is opened unless any of the following are true: 


[EACCES] 


[EACCES] 
(EACCES] 


[EAGAIN] 


(EEXIST] 


[EFAULT] 


Acomponent of the path prefix denies search permis- 
sion. 

oflag permission is denied for the named file. 
O_CREAT is specified, the file does not exist, and the 


directory in which the entry for the file is to be created 
does not permit writing. 


The file exists, mandatory file/record locking is set, and 
there are outstanding record locks on the file (see 
chmod (2)]. 


O_CREAT and O_EXCL are set, and the named file 
exists. 


path points outside the allocated address space of the 
process. 
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[EINTR] A signal was caught during the open system call. 
@ [EIO) A hangup or error occurred during a STREAMS open. 

[EIO] An I/O error occurred while reading from or writing to 
the file system. 

{EIO] A special file generated an I/O error. 

(EISDIR] The named file is a directory and oflag is write or 
read/write. 

[ELOOP] Too many symbolic links were encountered in translat- 
ing path. 

[EMFILE] NOFILES file descriptors are currently open (see 
intro(2)). 

(ENAMETOOLONG] Path was longer than PATH_MAX characters. 

[ENAMETOOLONG] Path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX char- 
acters. 

[ENAMETOOLONG] Acomponent of path was longer than NAME_MAX 
characters, 

[ENFILE] The system file table is full. 

[ENOENT] O_CREAT is not set and the named file does not exist. 

[ENOENT] Acomponent of path which must exist does not exist. 

© [ENOSPC] O_CREAT is set, and the filesystem is out of inodes. 

(ENOSPC] O_CREAT is specified, and the directory in which the 
entry for the new file is being placed cannot be expanded 
because there is no space left on the file system contain- 
ing the directory. 

[ENOSR] Unable to allocate a stream. 

{ENOTDIR] Acomponent of the path prefix is not a directory. 

fENXIO] The named file is a character special or block special file, 
and the device associated with this special file does not 
exist. 

[ENXIO] O_NONBLOCK is set, the named file is a FIFO, 
O_WRONLY is set, and no process has the file open for 
reading. 

(ENXIO]} ASTREAMS module or driver open routine failed. 

[EROFS] The named file resides on a read-only filesystem and 
oflag is write or read/write. 

(ETXTBSY] The file is a pure procedure (shared text) file that is 
being executed and oflag is write or read/write. 

SEE ALSO 

chmod(2), close(2), creat(2), dup(2), fentl(2), intro(2), lseek(2), read(2), 

| & getmsg(2), putmsg(2), umask(2), write(2), getdtablesize(2seq) 
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DIAGNOSTICS 
Upon successful completion, the file descriptor is returned. Otherwise, a value 
of —1 is returned and errno is set to indicate the error. 
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NAME 


@ SYNOPSIS 


pathconf, fpathconf — get configurable pathname variables 


include <unistd.h> 

long pathconf (path, name) 
char *path; 

int name; 

long fpathconf (fildes, name) 
int fildes, name; 


DESCRIPTION 
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The pathconf and fpathconf functions provide a method for the application 
to determine the current value of a configurable limit or option (variable) that 
is associated with a file or a directory. 

For pathconf, the path argument points to the pathname of a file or direc- 
tory. 

For fpathconf, the fildes argument is an open file descriptor. 

The name argument represents the variable to be queried relative to that file 
or directory. 

The following table lists the supported variables. These variables come from 
<limits.h> or <unistd.h> and the symbolic constants, defined in <unistd.h>, 
that are the corresponding values used for name: 


Configurable Pathname Variables 


Variable name Value Notes 
LINK_MAX _PC_LINK_MAX 1 
MAX_CANON _PC_MAX_CANON 2 
MAX_INPUT _PC_MAX: INPUT 2 
NAME_MAX _PC_NAME_MAX 3,4 
PATH_MAX _PC_PATH_MAX 4,5 
PIPE_BUF _PC_PIPE_BUF 6 
_POSIX_CHOWN_RESTRICTED _PC_CHOWN_RESTRICTED 7 
_POSIX_NO_TRUNG _PC_NO_TRUNG 2 
_POSIX_VDISABLE _PC_VDISABLE 2 


The following notes apply to the entries above: 

1. If path or fildes refers to a directory, the value returned applies to the 
directory itself. 

2. The behavior is undefined if path or fildes does not refer to a terminal file. 


3. If path or fildes refers to a directory, the value returned applies to 
filenames within the directory. 

4. The behavior is undefined if path or fildes does not refer to a directory. 
5. If path or fildes refers to a directory, the value returned is the maximum 
length of a relative pathname when the specified directory is the working 
directory. 
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6. If path refers to a FIFO, or fildes refers to a pipe or a FIFO, the value 
returned applies to the referenced object itself. If path or fildes refer toa 
directory, the value returned applies to any FIFOs that exist or that can be 
created within the directory. If path or fildes refer to any other type of file, 
the behavior is undefined. 


7. If path or fildes refer to a directory, the value returned applies to any files 
defined in this standard, other than directories, that exist or that can be 
created within the directory. 

DIAGNOSTICS 
If name is an invalid value, pathconf and fpathconf return -1. 


If the variable corresponding to name has no limit for the path or file descrip- 
tor, pathconf and fpathconf return -1 without changing errno. 


If path is needed to determine the value of name, and the association of name 
with the file specified by path is not supported, or if the process did not have 
the appropriate privileges to query the file specified by path, or path does not 
exist, the pathconf function returns -1. 


If fildes is needed to determine the value of name, and the association of 
name with the file specfied by fildes is not supported, or if fildes is an invalid 
file descriptor, fpathconf returns -1. 


Otherwise, pathconf and fpathconf return the current variable value for 
the file or directory without changing errno. The value returned is not more 
restrictive than the corresponding value described to the application when it 
was compiled with <limits.h> or <unistd.h>. 


If the following condition occurs, pathconf and fpathconf return -1 and set 
errno to the corresponding value: 


[EINVAL] The value of name is invalid. 


If any of the following conditions is detected, pathconf returns -1 and sets 
errno to the corresponding value: 


[EACCES] Search permmision is denied for a component of the 
path prefix. 

(EINVAL) The association of the variable name with the specified 
file is not supported. 

[FIO] An J/O error occurred while reading from or writing to 
the file system. : 

[ELOOP] Too many symbolic links were encountered in translat- 
ing path. 


[ENAMETOOLONG] The length of the path argument exceeds PATH_MAX, 
or a pathname component is longer than NAME_MAX 
while _POSIX_NO_TRUNC is in effect. 


[ENAMETOOLONG] Path referenced a symbolic link which, when expanded, . 
resulted in a path name longer than PATH_MAX char- 
acters. 
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[ENOENT] The named file does not exist or the path argument 
points to an empty string. 

(ENOTDIR] Acomponent of the path prefix is not a directory. 

[EFAULT] path points outside the allocated address space of the 
process. 


If any of the following conditions is detected, fpathconf returns -1 and sets 
errno to the corresponding value: 


[EBADF] The fildes argument is not a valid file descriptor. 
[EINVAL] The association of the variable name with the specified 
file is not supported. 
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NAME 

pause — suspend process until signal 
SYNOPSIS 

pause () 
DESCRIPTION 


pause suspends the calling process until it receives a signal. The signal must 
be one that is not currently set to be ignored by the calling process. 


If the signal causes termination of the calling process, pause will not return. 


If the signal is caught by the calling process and control is returned from the 
signal-catching function (see signal(2)), the calling process resumes execution 
from the point of suspension; with a return value of —1 from pause and errno 
set to EINTR. 


SEE ALSO 
alarm(2), kill(2), signal(2), sigpause(2), wait(2) 
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NAME 


=) SYNOPSIS 


pipe — create an interprocess channel 


int pipe (fildes) 
int fildes[2]; 


DESCRIPTION 


pipe creates an I/O mechanism called a pipe and returns two file descriptors, 
fildes[0] and fildes[{1]. fildes[0] is opened for reading and fildes[1] is opened 
for writing. 

Up to PIPE_BUF bytes of data are buffered by the pipe before the writing pro- 
cess is blocked. A read-only file descriptor fildes[0] accesses the data written 
to fildes[1] on a first-in-first-out (FIFO) basis. 


pipe fails if any of the following are true: 


[EMFILE] NOFILES file descriptors are currently open (see intro(2)). 
[ENFILE] The system file table is full. 
[ENFILE] The number of pipes in the system exceeds the configured 


maxinum number of pipes. 


If fildes is an invalid address in the process’s address space, the results will be 
unpredictable, possibly resulting in a core dump. 


SEE ALSO 


sh(1), intro(2), read(2), write(2), getdtablesize(2seq) 


& DIAGNOSTICS 
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Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 
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NAME 


plock — lock process, text, or data in memory 


SYNOPSIS 


#include <sys/lock.h> 


int plock (op) 
int op; 


DESCRIPTION 


plock allows the calling process to lock its text segment (text lock), its data 
segment (data lock), or both its text and data segments (process lock) into 
memory. Locked segments are immune to all routine swapping. plock also 
allows these segments to be unlocked. The effective user ID of the calling pro- 
cess must be superuser to use this call. op specifies the following: 


PROCLOCK lock text and data segments into memory (process lock) 
TXTLOCK lock text segment into memory (text lock) 

DATLOCK _ lock data segment into memory (data lock) 

UNLOCK remove locks 


plock fails and does not perform the requested operation if any of the follow- 
ing are true: 


[EAGAIN] Not enough memory. 

[EINVAL] op is equal to PROCLOCK and a process lock, a text lock, or a 
data lock already exists on the calling process. 

[EINVAL] op is equal to TXTLOCK and a text lock, or a process lock 
already exists on the calling process. 

[EINVAL] op is equal to DATLOCK and a data lock, or a process lock 
already exists on the calling process. 

{EINVAL] op is equal to UNLOCK and no type of lock exists on the cal- 
ling process. 

{EPERM]) The effective user ID of the calling process is not superuser. 

SEE ALSO 


exec(2), exit(2), fork(2), vm_ctl(2seq) 


DIAGNOSTICS 


NOTES 
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Upon successful completion, a value of 0 is returned to the calling process. 
Otherwise, a value of —1 is returned and errno is set to indicate the error. 


Currently, the entire process is marked as being immune to all swapping 
when any of the individual segments are locked. Programs should not mix 
plock calls with the VM_SWAPABLE case of vm_ctl(2seq) since they have 
the same effect and can interact with each other. In particular, a call to 
vm_ctl followed by calls to plock to lock and subsequently unlock the process 
will have the effect of disabling the original call to vm_ctl. 
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NAME 


© SYNOPSIS 


poll — STREAMS input/output multiplexing 


#include <stropts.h> 
#include <poll.h> 

int poll(fds, nfds, timeout) 
struct pollfd fds[]; 
unsigned long nfds; 

int timeout; 


DESCRIPTION 
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poll provides users with a mechanism for multiplexing input/output over a set 
of file descriptors that reference open streams (see intro(2)). poll identifies 
those streams on which a user can send or receive messages, or on which cer- 
tain events have occurred. A user can receive messages using read(2) or 
getmsg(2) and can send messages using write(2) and putmsg(2). Certain 
ioctl(2) calls, such as IL RECVFD and I_SENDFD (see streamio(7)), can also be 
used to receive and send messages. 


fds specifies the file descriptors to be examined and the events of interest for 
each file descriptor. It is a pointer to an array with one element for each open 
file descriptor of interest. The array’s elements are pollfd structures which 
contain the following members: 


int fd; /* file descriptor */ 
short events; /* requested events */ 
short revents; /* returned events */ 


where fd specifies an open file descriptor and events and revents are bit- 
masks constructed by or-ing any combination of the following event flags: 


POLLIN A non-priority or file descriptor passing message (see I_LRECVFD) 
is present on the stream head read queue. This flag is set even if 
the message is of zero length. In revents, this flag is mutually 
exclusive with POLLPRI. 


POLLPRI A priority message is present on the stream head read queue. 
This flag is set even if the message is of zero length. In revents, 
this flag is mutually exclusive with POLLIN. 


POLLOUT The first downstream write queue in the stream is not full. Pri- 
ority control messages can be sent (see putmsg) at any time. 


POLLERR An error message has arrived at the stream head. This flag is 
only valid in the revents bitmask; it is not used in the events 
field. 


POLLHUP A hangup has occurred on the stream. This event and POLLOUT 
are mutually exclusive; a stream can never be writable ifa 
hangup has occurred. However, this event and POLLIN or 
POLLPRI are not mutually exclusive. This flag is only valid in the 
revents bitmask; it is not used in the events field. 
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POLLNVAL The specified fd value does not belong to an open stream. This 
flag is only valid in the revents field; it is not used in the events 
field. 


For each element of the array pointed to by fds, poll examines the given file 
descriptor for the event(s) specified in events. The number of file descriptors 
to be examined is specified by nfds. If nfds exceeds NOFILES, the system 
limit of open files (see intro(2)), poll fails. 


If the value fd is less than zero, events is ignored and revents is set to 0 in 
that entry on return from poll. 


The results of the poll query are stored in the revents field in the pollfd 
structure. Bits are set in the revents bitmask to indicate which of the 
requested events are true. If none are true, none of the specified bits is set in 
revents when the poll call returns. The event flags POLLHUP, POLLERR and 
POLLNVAL are always set in revents if the conditions they indicate are true; 
this occurs even though these flags were not present in events. a 


If none of the defined events have occurred on any selected file descriptor, poll 

_ waits at least timeout msec for an event to occur on any of the selected file 
descriptors. On a computer where millisecond timing accuracy is not avail- 
able, timeout is rounded up to the nearest legal value available on that sys- 
tem. If the value timeout is 0, poll returns immediately. If the value of 
timeout is -1, poll blocks until a requested event occurs or until the call is 
interrupted. poll is not affected by the O_NDELAY flag. 


poll fails if one or more of the following are true: 


[EAGAIN] Allocation of internal data structures failed but request should 
be attempted again. 


[EFAULT] Some argument points outside the allocated address space. 
[EINTR] Asignal was caught during the poll system call. 
[EINVAL] The argument nfds is less than zero, or nfds is greater than 


NOFILES (see intro(2)). 
SEE ALSO 
intro(2), getmsg(2), putmsg(2), read(2), streamio(7), write(2) 
DIAGNOSTICS 


Upon successful completion, a non-negative value is returned. A positive 
value indicates the total number of file descriptors that has been selected (i.e., 
file descriptors for which the revents field is non-zero). A value of 0 indicates 
that the call timed out and no file descriptors have been selected. Upon fail- 
ure, a value of -1 is returned and errno is set to indicate the error. 
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NAME 


© SYNOPSIS 


profil — execution time profile 


void profil (buff, bufsiz, offset, scale) 
char *buff; 
int bufsiz, offset, scale; 


DESCRIPTION 


buff points to an area of core whose length (in bytes) is given by bufsiz. After 
this call, the user’s program counter (pc) is examined each clock tick. Then the 
value of offset is subtracted from it, and the remainder multiplied by scale. 
If the resulting number corresponds to an entry inside buff, that entry is 
incremented. An entry is defined as a series of bytes with length 
sizeof(short). 


The scale is interpreted as an unsigned, fixed-point fraction with binary point 
at the left: 0177777 (octal) gives a 1-1 mapping of pc’s to entries in buff; 
077777 (octal) maps each pair of instruction entries together. 02(octal) maps 
all instructions onto the beginning of buff (producing a non-interrupting core 
clock). 


Profiling is turned off by giving a scale of 0 or 1. It is rendered ineffective by 
giving a bufsiz of 0. Profiling is turned off when an exec is executed, but 
remains on in child and parent both after a fork. Profiling will be turned off if 
an update in buff would cause a memory fault. 


SEE ALSO 


© DIAGNOSTICS 
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prof(1), times(2), monitor(3C) 


Not defined. 
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NAME 


© SYNOPSIS 


ptrace, mptrace — process trace facility 


#include <signal.h> 

#include <sys/ptrace.h> 
ptrace(request, pid, addr, data) 
int request, pid, *addr, data; 


mptrace(request, pid, addr, data) 
int request, pid, *addr, data; 


DESCRIPTION 


ptrace and mptrace provide a means by which a process may control the 
execution of other processes, and examine and change their memory image. 
Their primary use is for the implementation of breakpoint debugging. 


There are four arguments whose interpretation depends on a request argu- 
ment. Generally, pid is the process ID of the traced process, which is typically 
a descendant of the tracing process. A process being traced behaves normally 
until it encounters some signal, either internally generated like illegal 
instruction or externally generated like interrupt (see signal(2) for the list), or 
performs one of several state changes (fork, exec, exit). Then the traced pro- 
cess enters a stopped state and its debugger is notified with SIGCHLD. In the 
case of a fork, only the child stops (to allow the debugger to maintain a process 
tree model). When a process is in the stopped state, its memory image can be 
examined and modified using ptrace or mptrace. If desired, another ptrace 
or mptrace request can then cause the process either to terminate or to con- 
tinue, possibly taking a signal. 


The value of the request argument determines the precise action of the call, 
for ptrace: 


PT_CHILD 
This request is the only one used by the child process; it declares that 
the process is to be traced by its parent, which is not using any of the 
XPT_ functions. All the other arguments are ignored. Peculiar results 
will ensue if the parent does not expect to trace the child. The child 
process requesting to be traced must exec(2) an image before ptrace 
requests generated by the parent process are effective. PT_CHILD is not 
used by multi-process debuggers. 


PT_RDATA, PT_RTEXT 
The word in the process’s address space at addr is returned as a func- 
tion return value. If I and D space are separated (e.g., historically on a 
pdp-11), request PT_RTEXT indicates I space, PT_RDATA D space. 
addr must be even. The process must be stopped. The input data is 
ignored. 


PT_RUSER 
The word of the system’s per-process data area corresponding to addr is 
returned as a function return value. addr must be even and less than 
sizeof(struct user) or correspond to the actual kernel address. This 
space contains the registers and other information about the process; 
its layout corresponds to the user structure in the system (see 
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<sys/user.h>). The value of the data argument is ignored. 


PT_WDATA, PT_WTEXT 
The given data is written at the word in the process’s address space 
corresponding to addr. No useful value is returned. 


PT_WUSER 
The process’s system data is written, as it is read with request 
PT_RUSER. Only a few locations can be written in this way: the general 
registers, the floating-point status and registers, and certain bits of the 
processor status word. 


PT_CONTSIG 
The data argument is taken as a signal number and the process’s execu- 
tion continues at location addr as if it had incurred that signal. Nor- 
mally the signal number will be either 0 to indicate that the signal that 
caused the stop should be ignored, or that value fetched out of the pro- 
cess’s image indicating which signal caused the stop. If addris (int 
*) 1 then execution continues from where it stopped. 


PT_KILL 
The traced process terminates. However, if the process is a descendent 
of a multi-process debugger, the process will stop in exit (if it has not 
already done so), waiting to be continued before proceeding to termi- 
nate. 


PT_SSTEP 
Execution continues as in request PT_CONTSIG; however, as soon as 
possible after execution of at least one instruction, execution stops 
again. The signal number from the stop is SIGTRAP. This is part of the 
mechanism for implementing breakpoints. 


Unlike a single process debugger all decendants of the process declared as a 
multi-process debugger are traced and do not require themselves to use 
PT_CHILD as in ptrace(2). These are the arguments to mptrace: 


XPT_DEBUGGER 
A process uses this request to declare itself a multi-process debugger. 
All other arguments are ignored. All subsequent forks, execs, and 
exits, as well as signals of all children of the calling process, their 
descendants, and selected other processes (see XPT_DEBUG), notify the 
debugger with SIGCHLD. 


XPT_SETSIGMASK 
The addr parameter points to a mask of signals in the selected pro- 
cess. The mask may be set using sigaddset() or cleared using sigdel- 
set(). Signals so set are passed directly to the selected process, rather 
than notifying the debugger and stopping the process. This mask is 
inherited across forks of the process, and kept when the process 
exec’s. A passed-through signal is a process attribute; it is passed 
through regardless of how many debuggers are controlling the process. 


XPT_RREGS, XPT_WREGS 
The selected process’s register set is read or written. addr points to a 
pt_regset structure (see ptrace.h). Machine specific restrictions 
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usually apply; for example, typically only a few of the processor-status 
register bits are actually written. 


XPT_RPROC 
The selected process’s process table entry is placed at *addr. See 
<sys/proc.h> for definition of struct proc. 


XPT_SIGNAL 
The data argument is a signal number that is sent to process selected 
by pid. If pid==0, the signal is sent to all processes under control of 
the debugger. 


XPT_STOPSTAT 
Information about a stopped process is returned. The pid argument is 
ignored. A debugged process stops whenever it forks, execs, exits, or 
is about to process a signal, and sends the debugger a SIGCHLD. addr 
points at a pt_stop structure, which receives the pid and reason for 
the stop. If no controlled process is stopped that has not yet been 
reported by XPT_STOPSTAT, an ESRCH error is returned. 


XPT_DUPFD 
The open file descriptor in the caller given by data is dup’d (see 
dup(2)) into pid’s file-descriptor named by addr. If pid already has an 
open file-descriptor there it is closed. This is an experimental interface. 


The following functions are not supported in the first implementation: 


XPT_DEBUG 
The process tree rooted at pid becomes controlled by the debugger. 
pid must not be an ancestor of the debugger or already under debug. 
The caller must be root or match the effective uid of all processes in 
.the selected process tree. No process in the tree can be running a set- 
user or set-group process. 


XPT_OPENT 
ptrace returns an open, read-only file descriptor for the binary file 
being executed by pid. The debugger must have read-access to the file 
for this to succeed. This allows the debugger to access the symbol 
table without having to know the name of the executable file. 


To forestall possible fraud, ptrace inhibits the set-user-id and set-group-id 
facilities on subsequent execve(2) calls. 


DIAGNOSTICS 


A0 value is returned if the call succeeds. If the call fails, a—1 is returned and 
errno is set to indicate the error. However, some ptrace commands return 
data as the function return value. Since —1 may be a legal (successful) return 
value, errno should be used to disambiguate. 


The following errors may occur: 


[EBADF] The data or addr argument specifies a bad file descriptor num- 
ber for XPT_DUPFD. 


(EFAULT] The specified address is out of bounds. 
(EINVAL) The given signal number is invalid. 
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[EINVAL] The request code is invalid. 


[EIO] The child cannot perform the task requested. 
[EPERM] The specified process cannot be traced. 
(ESRCH] The specified process does not exist. 
[ESRCH] The process is not stopped. 
[ESRCH] The process to be traced is not a descendant of the current pro- 
cess. 
SEE ALSO 
wait(2), signal(2) 


BUGS 
The —1 error indication is a legitimate function value; errno, can be used to 
disambiguate. (see intro(2)) 


Physical mapped address space, (MM_PHYS, can’t be read or written using 
these interfaces (see mmap(2)). 


NOTES 
To use mptrace, libseq must be linked to the image using the ~Iseq option to 
, the loader. The mptrace-specific structures mentioned above are defined 
below; the pt_regset structure is machine dependent. 


structpt_stop { 
int ps_pid; /* pid of stopped process */ 
int ps_reason; /* reason for the stop */ 


We 


structpt_regset { 
/* 


* General registers and processor status. 


int pr_r0; 
int pr_rly; 
int pr_r2; 
dnt pr_r3; 
int pr_r4; 
int pr_xrs; 
int pr_r6; 
int pr_ry; 


int pr_fp; 

int Pr_sp; 

int pr_pc; 

int pr_modpsr; 
/* 

* Floating point registers and status. 
*/ 

int  pr_f0; 

int pr_fl; 

int pr_f2; 

int pr_f3; 
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int 
int 
int 
int 
int 
Me 
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pr_f4; 
pr_f5; 
pr_f6; 
pr_f7; 
pr_fsr; 


Reasons for a stop are a signal number (1 - NSIG), or one of 
PTS_FORK, PTS_EXEC, or PTS EXIT, encoded to be unambiguous. A 
PTS FORK stop only occurs in the child of the fork. An imme- 
diate child of the debugger does not stop with PTS FORK. 


DYNIX/ptx PUTMSG(2) 


NAME 


S SYNOPSIS 


putmsg — send a message on a stream 


#include <stropts.h> 


. int putmsg (fd, ctlptr, dataptr, flags) 


int fd; 

struct strbuf *ctlptr; 
struct strbuf *dataptr; 
int flags; 


DESCRIPTION 
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putmsg creates a message (see intro(2)) from user-specified buffer(s) and 
sends the message to a STREAMS file. The message may contain either a data 
part, a control part or both. The data and control parts to be sent are dis- 
tinguished by placement in separate buffers, as described below. The seman- 
tics of each part are defined by the STREAMS module that receives the mes- 
sage. 

fd specifies a file descriptor referencing an open stream. ctlptr and dataptr 
each point to a strbuf structure which contains the following members: 


int maxlen; /* not used */ 
int len; /* length of data */ 
char *buf; /* ptr to buffer */ 


ctlptr points to the structure describing the control part, if any, to be included 
in the message. The buf field in the strbuf structure points to the buffer 
where the control information resides, and the len field indicates the number 
of bytes to be sent. The maxlen field is not used in putmsg (see getmsg(2)). 
In a similar manner, dataptr specifies the data, if any, to be included in the 
message. flags may be set to the values 0 or RS_HIPRI and is used as 
described below. 


To send the data part of a message, dataptr must be non-NULL and the len 
field of dataptr must have a value of 0 or greater. To send the control part of 
a message, the corresponding values must be set for ctlptr. No data (control) 
part is sent if either dataptr (ctlptr) is NULL or the len field of dataptr 
(ctlptr) is set to -1. 


If a control part is specified, and flags is set to RS_HIPRI, a high-priority mes- 
sage is sent. If flags is set to 0, a non-priority message is sent. If no control 
part is specified, and flags is set to RS_HIPRI, putmsg fails and sets errno to 
EINVAL. If no contro] part and no data part are specified, and flags is set to 0, 
no message is sent, and 0 is returned. 


For non-priority messages, putmeg blocks if the stream write queue is full 
due to internal flow control conditions. putmsg does not block for priority 
messages. For non-priority messages, putmsg does not block when the write 
queue is full and O_NDELAY is set. Instead, it fails and sets errno to EAGAIN. 


putmeg also blocks, unless prevented by lack of internal resources, waiting 
for the availability of message blocks in the stream, regardless of priority or 
whether O_NDELAY has been specified. No partial message is sent. 
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putmeg fails if any of the following are true: 


[EAGAIN] 


[EAGAIN] 


(EBADF] 
[EFAULT] 
[EINTR] 
[EINVAL] 


(EINVAL) 
[ENOSTR] 
[ENXIO] 


[ERANGE] 


Anon-priority message was specified, the O_NDELAY flag is set 
and the stream write queue is full due to internal flow control 
conditions. 


Buffers could not be allocated for the message that was to be 
created. 

fd is not a valid file descriptor open for writing. 

etlptr or dataptr points outside the allocated address space. 
A signal was caught during the putmsg system call. 

An undefined value was specified in flags, or flags is set to 
RS_HIPRI and no control part was supplied. 

The stream referenced by fd is linked below a multiplexor. 
Astream is not associated with fd. 


A hangup condition was generated downstream for the specified 
stream. 


The size of the data part of the message does not fall within the 
range specified by the maximum and minimum packet sizes of 
the topmost stream module. This value is also returned if the 
control part of the message is larger than the maximum config- 
ured size of the control part of a message, or if the data part ofa 
message is larger than the maximum configured size of the data 
part of a message. 


A putmeg also fails if a STREAMS error message had been processed by the 
stream head before the call to putmsg. The error returned is the value con- 
tained in the STREAMS error message. 


SEE ALSO 


intro(2), read(2), getmsg(2), poll(2), write(2) 


DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


read — read from file 


SYNOPSIS 


int read (fildes, buf, nbyte) 
int fildes; 

char *buf; 

unsigned nbyte; 


DESCRIPTION 
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fildes is a file descriptor obtained from a creat(2), open(2), dup(2), fentl(2), 
or pipe(2) system call. 

read attempts to read nbyte bytes from the file associated with fildes into 
the buffer pointed to by buf. 


On devices capable of seeking, the read starts at a position in the file given by 
the file pointer associated with fildes. Upon return from read, the file pointer 
is incremented by the number of bytes actually read. 


Devices that are incapable of seeking always read from the current position. 
The value of a file pointer associated with such a file is undefined. 


Upon successful completion, read returns the number of bytes actually read 
and placed in the buffer; this humber may be less than nbyte if the file is 
associated with a communication line (see ioctl(2) and termio(7)), or if the 
number of bytes left in the file is less than nbyte bytes. A value of 0 is 
returned when an end-of-file has been reached. 


A read from a STREAMS file (see intro(2)) can operate in three different 
modes: byte-stream mode , message-nondiscard mode, and message-discard 
mode. The default is byte-stream mode. This can be changed using the 
ILSRDOPT ioctl request (see streamio(7)), and can be tested with the 
ILGRDOPT ioctl. In byte-stream mode, read retrieves data from the stream 
until it has retrieved nbyte bytes, or until there is no more data to be 
retrieved. Byte-stream mode ignores message boundaries. 


In STREAMS message-nondiscard mode, read retrieves data until it has read 
nbyte bytes, or until it reaches a message boundary. If the read does not 
retrieve all the data in a message, the remaining data are replaced on the 
stream, and can be retrieved by the next read or getmsg(2) call. Message- 
discard mode also retrieves data until it has retrieved nbyte bytes, or it 
reaches a message boundary. However, unread data remaining in a message 
after the read returns are discarded, and are not available for a subsequent 
read or getmsg. 


When attempting to read from a regular file with mandatory file/record lock- 
ing set (see chmod(2)), and there is a blocking (i.e. owned by another process) 
write lock on the segment of the file to be read: 


If O_NONBLOCK is set, the read returns a -1 and sets errno to 
EAGAIN. 


If O_NONBLOCK is clear, the read sleeps until the blocking record lock 
is removed. 


When attempting to read from an empty pipe (or FIFO): 
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If O_NONBLOCK is set, the read returns a -1 and sets errno to 
EAGAIN. 


If O_NONBLOCK is clear, the read blocks until data is written to the 
file or the file is no longer open for writing. 


When attempting to read a file associated with a tty that has no data cur- 
rently available: 


If O_NONBLOCK is set, the read returns a -1 and sets errno to 
EAGAIN. 


If O_NONBLOCK is clear, the read blocks until data becomes available. 


When attempting to read a file associated with a stream that has no data cur- 
rently available: 


If O_NONBLOCK is set, the read returns a -1 and sets errno to 
EAGAIN. 


If O_NONBLOCK is clear, the read blocks until] data becomes available. 


When reading from a STREAMS file, handling of zero-byte messages is deter- 
mined by the current read mode setting. In byte-stream mode, read accepts 
data until it has read nbyte bytes, or until there is no more data to read, or 
until a zero-byte message block is encountered. read then returns the num- 
ber of bytes read, and places the zero-byte message back on the stream to be 
retrieved by the next read or getmsg. In the two other modes, a zero-byte 
message returns a value of 0 and the message is removed from the stream. 
When a zero-byte message is read as the first message on a stream, a value of 
0 is returned regardless of the read mode. 


A read from a STREAMS file can only process data messages. It cannot pro- 
cess any type of protocol message and fails if a protocol message is encoun- 
tered at the stream head. 


read fails if any of the following are true: 


[EAGAIN] Mandatory file/record locking was set, O NONBLOCK was set, 
and there was a blocking record lock. 


{EAGAIN] Total amount of system memory available when reading via 
raw I/O is temporarily insufficient. 

[EAGAIN) No message waiting to be read on a stream and O_NONBLOCK 
flag set. 

[EBADF] fildes is not a valid file descriptor open for reading. 


[EBADMSG] Message waiting to be read on a stream is not a data message. 


[EDEADLK] The read was going to go to sleep, causing a deadlock situa- 
tion to occur. 


[EFAULT] buf points outside the allocated address space. 

(EINTR] Asignal was caught during the read system call. 

[EINVAL] Attempted to read from a stream linked to a multiplexor. 

{EIO] An I/O error occurred while reading from or writing to the file 
system. 


2 12/89 


DYNIX/ptx READ(2) 


(EIO] The process is in a background process group and is attempt- 
ing to read from its controlling terminal. Either the process is 
ignoring or blocking the SIGTTIN signal, or the process group 
of the process is orphaned. 


[ENOLCK] The system record lock table was full, so the read could not go 
to sleep until the blocking record lock was removed. 


[ENOMEM] The size of the read requested from a raw device would have 
required the process to exceed its maximum resident set size. 


A read from a STREAMS file also fails if an error message is received at the 
stream head. In this case, errno is set to the value returned in the error mes- 
sage. If a hangup occurs on the stream being read, read continues to operate 
normally until the stream head read queue is empty. Thereafter, it returns 0. 


SEE ALSO 
creat(2), dup(2), fentl(2), ioctl(2),intro(2), open(2), pipe(2), getmsg(2), 
streamio(7), termio(7) 


DIAGNOSTICS 
Upon successful completion a non-negative integer is returned indicating the 
number of bytes actually read. Otherwise, a —1 is returned and errno is set 
to indicate the error. 


12/89 


DYNIX/ptx RENAME(2) 


NAME 
rename — change the name of a file 


SYNOPSIS 
rename(from, to) 
char *from, *to; 

DESCRIPTION 
Rename causes the link named from to be renamed as to. If to exists, then it 
is first removed. Both from and to must be of the same type (that is, both 
directories or both non-directories), and must reside on the same file system. 


Rename guarantees that an instance of to always exists, even if the system 
should crash in the middle of the operation. 


WARNING 
The system can deadlock if a loop in the file system graph is present. This loop 
takes the form of an entry in directory a, say a/foo, being a hard link to 
directory b, and an entry in directory b, say b/bar, being a hard link to 
directory a. When such a loop exists and two separate processes attempt to 
perform rename a/foo b/barand rename b/bar a/foo, respectively, the 
system may deadlock attempting to lock both directories for modification. 
Hard links to directories should be replaced by symbolic links by the system 
administrator. 


DIAGNOSTICS 
A 0 value is returned if the operation succeeds, otherwise rename returns —1 
and the global variable errno indicates the reason for the failure. 


Rename fails and neither of the argument files is affected if any of the follow- 


ing are true: 

(EACCES] Acomponent of either path prefix denies search permis- 
sion. 

[EACCES] The requested link requires writing in a directory with a 
mode that denies write permission. 

[EACCESS] The caller is not the superuser and the parent directory 
has the sticky bit set and the ¢o or the from file is not 
writable by the user and the user does not own the par- 
ent directory and the user does not own the ¢o or the 
from file. 

[EBUSY] Either the directory named by to or the directory named 
by from is the object of a concurrent mount operation. 

[EFAULT] From or to points outside the process’s allocated address 
space. 

[EINVAL] From is a parent directory of to. 

[EINVAL] The directory named by Zo is the caller’s current work- 
ing directory. 

(EEXIST] The link named by #o is a directory containing entries 
other than dot and dot-dot. 

{EIO] An I/O error occurred while reading from or writing to 
the file system. 
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{EISDIR] 
[ELOOP] 
[ENAMETOOLONG] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


{ENOENT] 
[ENOENT] 
[ENOSPC] 


[ENOTDIR] 
" [ENOTDIR] 
[EROFS] 


[ETXTBSY] 


SEE ALSO 
open(2) 
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An attempt was mad to rename a non-directory file to an 
existing directory. 


Too many symbolic links were encountered in translat- 
ing the from pathname or the to pathname. 


The length of the from pathname or the to pathname 
exceeds PATH_MAX characters. 


The from pathname or the to pathname referenced a 
symbolic link which, when expanded, resulted in a path 
name longer than PATH_MAX characters. 


Acomponent of the from or to pathnames was longer 
than NAME_MAX characters. 


Acomponent of either path prefix does not exist. 
The file named by from does not exist. 


The directory in which the entry for the new name is 
being placed cannot be extended because there is no 
space left on the file system containing the directory. 


Acomponent of either path prefix is not a directory. 


An attempt was made to rename a directory to an exist- 
ing non-directory file. 

The requested link requires writing in a directory ona 
read-only file system. 

The file named by to or the file named by from is a pure 


procedure (shared text) file that is currently being exe- 
cuted. 
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NAME 


© SYNOPSIS 


RMDIR(2) 


rmdir — remove a directory 


int rmdir (path) 
char *path; 


DESCRIPTION 
rmdir removes the directory named by the path name pointed to by path. 
The directory must not have any entries other than "." and"..", 


The named directory is removed unless one or more of the following are true: 
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{EACCES] 


[EACCES] 


[EACCES] 


(EBUSY] 


(BEXIST] 


(EFAULT] 


[EINVAL] 
[EINVAL] 
(EIO] 
[EIO] 


[ELOOP] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


([ENAMETOOLONG] 


[ENOENT] 
(ENOTDIR] 
(EROFS] 


Search permission is denied for a component of the path 
prefix. 


Write permission is denied on the directory containing 
the directory to be removed. 


The parent directory has the sticky bit set and 
the parent directory is not owned by the user and 
the directory is not owned by the user and 

the directory is not writable by the user and 

the user is not superuser 


The directory to be removed is the mount point for a 
mounted file system. 


The directory contains entries other than those for "." 


path points outside the process’s allocated address 
space. 


The current directory may not be removed. 
The "." entry of a directory may not be removed. 
An l/O error occurred while accessing the file system. 


An /O error occurred while reading from or writing to 
the file system. 


Too many symbolic links were encountered in translat- 
ing path. 


Path was longer than PATH_MAX characters. 


Path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


The named directory does not exist. 
Acomponent of the path prefix is not a directory. 


The directory entry to be removed is part of a read-only 
file system. 
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DIAGNOSTICS 
: Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


SEE ALSO 
rmdir(1), rm(1), and mkdir(1), mkdir(2), unlink(2) 
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NAME 


semct] — semaphore control operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipe.h> 


“#include <sys/sem.h> 


int semct] (semid, semnum, cmd, arg) 
int semid, cmd; 

int semnum; 

union semun [ 

int val; 

struct semid_ds *buf; 

ushort *array; 

) arg; 


DESCRIPTION 
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semctl provides a variety of semaphore control operations as specified by 
cmd. 


The following cmds are executed with respect to the semaphore specified by 
semid and semnum: 


GETVAL Return the value of semval (see intro(2)). (READ} 


SETVAL Set the value of semval to arg.val. {ALTER} When this 
cmd is successfully executed, the semadj value corre- 
sponding to the specified semaphore in all processes is 
cleared. 


GETPID Return the value of sempid. (READ) 
GETNCNT Return the value of semncnt. (READ) 
GETZCNT Return the value of semzcnt. (READ} 


The following cmds return and set, respectively, every semval in the set of 
semaphores. 


GETALL Place semvals into array pointed to by arg.array. 
{READ} 


SETALL Set semvals according to the array pointed to by 
arg.array. {ALTER} When this cmd is successfully exe- 
cuted the semadj values corresponding to each specified 
semaphore in all processes are cleared. 


The following emds are also available: 


IPC_STAT, Place the current value of each member of the data 
structure associated with semid into the structure 
pointed to by arg.buf. The contents of this structure are 
defined in intro(2). (READ} 


IPC_SET Set the value of the following members of the data struc- 
ture associated with semid to the corresponding value 
found in the structure pointed to by arg.buf: 


sem_perm.uid 
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IPC_RMID 
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sem_perm.gid 
sem_perm.mode /* only low 9 bits */ 


This command can only be executed by a process that 
has an effective user ID equal to either that of superuser, 
or to the value of sem_perm.cuid or sem_perm.uid in 
the data structure associated with semid. 


Remove the semaphore identifier specified by semid 
from the system and destroy the set of semaphores and 
data structure associated with it. This command can 
only be executed by a process that has an effective user 
ID equal to either that of superuser, or to the value of 
sem_perm.cuid or sem_perm.uid in the data struc- 
ture associated with semid. 


semctl fails if any of the following are true: 


[EACCES] 


(EFAULT] 
[EINVAL] 
[EINVAL] 


[EINVAL] 
[EPERM] 


{ERANGE] 


SEE ALSO 


Operation permission is denied to the calling process 
(see intro(2)). 


arg-buf points to an illegal address. 
semid is not a valid semaphore identifier. 


semnum is less than zero or greater than 
sem_nsems. 


emd is not a valid command. 


emd is equal to IPC_RMID or IPC_SET and the effec- 
tive user ID of the calling process is not equal to that 
of superuser, or to the value of sem_perm.cuid or 
sem_perm.uid in the data structure associated with 
semid. 

emd is SETVAL or SETALL and the value to which 
semval is to be set is greater than the system 
imposed maximum. 


intro(2), semget(2), semop(2) 


DIAGNOSTICS 


Upon successful completion, the value returned depends on emd as follows: 
GETVAL The value of semval 

GETPID The value of sempid 

GETNCNT The value of semnent 

GETZCNT The value of semzcnt 

All others Avalue of 0 

Otherwise, a value of -1 is returned and errno is set to indicate the error. 
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NAME 
© semget — get set of semaphores 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 
int semget (key, nsems, semfig) 
key_t key; 
int nsems, semflg; 
DESCRIPTION 
semget returns the semaphore identifier associated with key. 


Asemaphore identifier and associated data structure and set containing 
nsems semaphores (see intro(2)) are created for key if any of the following is 
true: 
key is equal to IPC_PRIVATE. 
key does not already have a semaphore identifier associated with it, 
and (semflg & IPC_CREAT) is true. 
Upon creation, the data structure associated with the new semaphore identif- 
ier is initialized as follows: 
sem_perm.cuid, sem_perm.uid, sem_perm.cgid, and 
sem_perm.gid are set equal to the effective user ID and effective 
group ID, respectively, of the calling process. 
@a The low-order 9 bits of sem_perm.mode are set equal to the low- 
order 9 bits of semfig. 
sem_nsems is set equal to the value of nsems. 
sem_otime is set equal to 0 and sem_ctime is set equal to the cur- 
rent time. 


semget fails if any of the following are true: 


[EACCES] A semaphore identifier exists for key, but operation permis- 
sion [see intro(2)] as specified by the low-order 9 bits of 
semflg would not be granted. 

[EEXIST] A semaphore identifier exists for key but ((semflg & 
IPC_CREAT) and (semflg & IPC_EXCL)) is true. 

[EINVAL] nsems is either less than or equal to zero or greater than the 
system-imposed limit. 

[EINVAL] Asemaphore identifier exists for key, but the number of 


semaphores in the set associated with it is less than nsems, 
and nsems is not equal to zero. 


[ENOENT] Asemaphore identifier does not exist for key and (semflg & 
IPC_CREAT) is false. 

[ENOSPC] A semaphore identifier is to be created but the system- 
imposed limit on the maximum number of allowed semaphore 
identifiers system wide would be exceeded. 


12/9 = 1 


SEMGET(2) , DYNIX/ptx 


[ENOSPC] Asemaphore identifier is to be created but the system- 
imposed limit on the maximum number of allowed sema- 
phores system wide would be exceeded. 

SEE ALSO 
intro(2), semctl(2), semop(2) 
DIAGNOSTICS 


Upon successful completion, a non-negative integer, namely a semaphore 
identifier, is returned. Otherwise, a value of —1 is returned and errno is set 
to indicate the error. 
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NAME 


semop — semaphore operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/sem.h> 


int semop (semid, sops, nsops) 
int semid; 

struct sembuf **sops; 
unsigned nsops; 


DESCRIPTION 
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semop is used to automatically perform an array of semaphore operations on 
the set of semaphores associated with the semaphore identifier specified by 
semid. sops is a pointer to the array of semaphore-operation structures. 
nsops is the number of such structures in the array. The contents of each 
structure includes the following members: 


short sem_num; ./* semaphore number */ 
short sem_op; /* semaphore operation */ 
short sem_flg; /* operation flags */ 


Each semaphore operation specified by sem_op is performed on the corre- 
sponding semaphore specified by semid and sem_num. 


sem_op specifies one of three semaphore operations as follows: 
If sem_op is a negative integer, one of the following occurs: {ALTER} 


If semval (see intro(2)) is greater than or equal to the abso- 
lute value of sem_op, the absolute value of sem_op is sub- 
tracted from semval. Also, if (sem_filg & SEM_UNDO) is true, 
the absolute value of sem_op is added to the calling process’s 
semadj value (see exit(2)) for the specified semaphore. 


If semval is less than the absolute value of sem_op and 
(sem_fig & IPC_NOWAIT) is true, semop returns immedi- 
ately. 


If semval is less than the absolute value of sem_op and 
(sem_fig & IPC_NOWAIT) is false, semop increments the 
semnent associated with the specified semaphore and sus- 
pends execution of the calling process until one of the follow- 
ing conditions occur: 


semval becomes greater than or equal to the absolute 
value of sem_op. When this occurs, the value of semnent 
associated with the specified semaphore is decremented, 
the absolute value of sem_op is subtracted from semval 
and, if (sem_fig & SEM_UNDO) is true, the absolute value 
of sem_op is added to the calling process’s semadj value 
for the specified semaphore. 


The semid for which the calling process is awaiting action 
js removed from the system (see semctl(2)). When this 
occurs, errno is set equal to EIDRM, and a value of —1 is 
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returned. 


The calling process receives a signal that is to be caught. 
When this occurs, the value of semnent associated with 
the specified semaphore is decremented, and the calling 
process resumes execution in the manner prescribed in 


signal(2). 


If sem_op is a positive integer, the value of sem_op is added to sem- 
val and, if (sem_fig & SEM_UNDO) is true, the value of sem_op is 
subtracted from the calling process’s semadj value for the specified 
semaphore. {ALTER} 


If sem_op is zero, one of the following occurs: (READ) 


If semval is zero, semop returns immediately. 


If semval is not equal to zero and (sem_filg & PC_NOWAIT) is 
true, semop returns immediately. 


If semval is not equal to zero and (sem_fig & IPC_NOWAIT) 
is false, semop increments the semzcnt associated with the 
specified semaphore and suspends execution of the calling 
process until one of the following occurs: 


semval becomes zero, at which time the value of semzent 
associated with the specified semaphore is decremented. 


The semid for which the calling process is awaiting action is 
removed from the system. When this occurs, errno is set 
equal to EIDRM, and a value of —1 is returned. 


The calling process receives a signal that is to be caught. 
When this occurs, the value of semzcnt associated with the 
specified semaphore is decremented, and the calling process 
resumes execution in the manner prescribed in signal(2). 


semop fails if any of the following are true for any of the semaphore opera- 


tions specified by sops: 

[EACCES] Operation permission is denied to the calling process [see 
intro(2)] 

(EAGAIN] The operation would result in suspension of the calling pro- 
cess but (sem_filg & IPC_NOWAIT) is true. 

(EFAULT] sops points to an illegal address. 

[EFBIG] sem_num is less than zero or greater than or equal to the 
number of semaphores in the set associated with semid. 

[EIDRM] semop returned due to the removal of semid from the sys- 
tem. 

[EINVAL] semid is not a valid semaphore identifier. 

(EINVAL) The number of individual semaphores for which the calling 
process requests a SEM_UNDO would exceed the limit. 

(EINTR] semop returned due to the receipt of a signal. 
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([E2BIG] nsops is greater than the system-imposed maximum. 

[ENOSPC] The limit on the number of individual processes requesting 
an SEM_UNDO would be exceeded. 

(ERANGE] An operation would cause a semval to overflow the system- 
imposed limit. 

[ERANGE] An operation would cause a semadj value to overflow the sys- 


tem-imposed limit. 


Upon successful completion, the value of sempid for each semaphore specified 
in the array pointed to by sops is set equal to the process ID of the calling pro- 
cess. 


SEE ALSO 


exec(2), exit(2), fork(2), intro(2), semctl(2), semget(2) 


DIAGNOSTICS 
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If semop returns due to the receipt of a signal, a value of —1 is returned to the 
calling process and errno is set to EINTR. Ifit returns due to the removal of a 
semid from the system, a value of —1 is returned and errno is set to EIDRM. 


Upon successful completion, a value of zero is returned. Otherwise, a value of 
—1 is returned and errno is set to indicate the error. 
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NAME 
& setpgid — manipulate signal sets 
SYNOPSIS 
#include <sys/types.h> 


int setpgid (pid, pgid) 
pid_t pid, pgid; 

DESCRIPTION 
The setpgid function is used to either join an existing process group or cre- 
ate a new process group within the session of the calling process. The process 
group ID ofa session leader does not change. Upon successful completion, the 
process group ID of the process with a process ID that matches pid shall be 
set to pgid. As a special case, if pid is zero, the process ID of the calling pro- 
cess is used. Also, if pgid is zero, the process ID of the indicated process is 
used. 


On successful completion, setpgid returns a value of zero. Otherwise, a value 
of -1 is returned and errno is set to indicate the error. 


If any of the following conditions occur, setpgid returns -1 and sets errno to 
the corresponding value: 


[EACCES] The value of pid matches the process ID of a child process of 
the calling process and the child process has successfully exe- 
cuted one of the functions. 


[EINVAL] The value of pgid is less than zero or is greater than MAXPID. 
@ [ENOSYS] The setpgid function is not supported. 
(EPERM] The process indicated by pid is a session leader. 


The value of pid is valid but matches the process ID of a child 
of the calling process and the child process is not in the same 
session as the calling process. 

The value of pgid does not match the process ID of the indi- 
cated by pid, and there is no process with a process group with 
@ process group ID that matches the value of the pgid argu- 
ment in the same session as the calling process. 


{ESRCH) The value of the pid argument does not match the process ID 
of the calling process or of a child process of the calling process. 
SEE ALSO 
getpgerp(2), setsid(2), tesetpgrp(2), exec(2) 


12/89 1 


DYNIX/ptx SETPGRP(2) 


NAME 
setpgrp — set process group ID 
SYNOPSIS 
int setpgrp () 
DESCRIPTION 
setpgrp sets the process group ID of the calling process to the process ID of 
the calling process and returns the new process group ID. ‘ 


SEE ALSO 
exec(2), fork(2), getpid(2), intro(2), kill(2), signal(2), setsid(2) 


DIAGNOSTICS 
setpgrp returns the value of the new process group ID. 
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NAME 


eS SYNOPSIS 


setsid — create session and set process group ID 


#include <sys/types.h> 
pid_t setsid0 


DESCRIPTION 


If the calling process is not a process group leader, setsid creates a new ses- 
sion. The calling process is the session leader of this new session, the process 
group leader of a new process group, and has no controlling terminal. The pro- 
cess group ID of the calling process is set equal to the process ID of the calling 
process. The calling process is the only process in the new process group and 
the only process in the new session. 


Upon sucessful completion, setsid returns the value of the process group ID of 
the calling process. 


If the following condition occurs, setsid returns -1 and sets errno to the cor- 
responding value: 


[EPERM] The calling process is already a process group leader, or the pro- 
cess group ID of a process other than the calling process matches 
the process ID of the calling process. 


SEE ALSO 
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exec (2), exit(2), fork(2), getpid(2), kill(1), setuid(2), sigaction(2) 


DYNIX/ptx SETUID(2) 


NAME 


© SYNOPSIS 


setuid, setgid — set user and group IDs 


int setuid (uid) 
int uid; 
int setgid (gid) 
int gid; 


DESCRIPTION 


setuid (setgid) is used to set the real user (group) ID and effective user 
(group) ID of the calling process. 


If the effective user ID of the calling process is superuser, the real user (group) 
ID, effective user (group) ID, and saved set-user (group) ID are set to uid (gid). 


If the effective user ID of the calling process is not superuser, but its real user 
(group) ID is equal to uid (gid), the effective user (group) ID is set to uid (gid). 


If the effective user ID of the calling process is not superuser, but the saved 
set-user (group) ID from exec(2) is equal to uid (gid), the effective user 
(group) ID is set to uid (gid). 


setuid (setgid) fails if the following are true: 
[EINVAL] The uid is out of range. 


[EPERM] Real user (group) ID of the calling process is not equal to uid (gid) 
and its effective user ID is not superuser. 


2) SEE ALSO 
getuid(2), intro(2) 


DIAGNOSTICS 
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Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


& SYNOPSIS 


shmct] — shared memory control operations 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


int shmctl (shmid, cmd, buf) 
int shmid, cmd; 
struct shmid_ds *buf; 


DESCRIPTION 
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shmetl provides a variety of shared memory control operations as specified by 
emd. The following emds are available: 


IPC_STAT Place the current value of each member of the data struc- 
ture associated with shmid into the structure pointed to 
by buf. The contents of this structure are defined in 
intro(2). (READ} 


IPC_SET Set the value of the following members of the data struc- 
ture associated with shmid to the corresponding value 
found in the structure pointed to by buf: 
shm_perm.uid 
shm_perm.gid 
shm_perm.mode /* only low 9 bits */ 


This cmd can only be executed by a process that has an 
effective user ID equal to that of super user, or to the value 
of shm_perm.cuid or shm_perm.uid in the data struc- 
ture associated with shmid. 


IPC_RMID Remove the shared memory identifier specified by shmid 
from the system and destroy the shared memory segment 
and data structure associated with it. Ifthe shared mem- 
ory segment is still attached to a process, the shared mem- 
ory identifier will no longer be available for attachment by 
other processes and will be removed from the system only 
when the associated process terminates or detaches the 
segment. This cmd can only be executed by a process that 
has an effective user ID equal to that of super user, or to 
the value of shm_perm.cuid or shm_perm.uid in the 
data structure associated with shmid. 


SHM_LOCK Lock the shared memory segment specified by shmid in 
memory. This cmd is not supported. 


SHM_UNLOCK Unlock the shared memory segment specified by shmid. 


This cmd is not supported. 
shmctl fails if one or more of the following are true: 
[EACCES] emd is equal to IPC_STAT and {READ} operation permis- 
sion is denied to the calling process (see intro(2)). 
(EFAULT] buf points to an illegal address. 
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[EINVAL] 


{EINVAL} 


[EPERM] 


(EPERM] 


SEE ALSO 


DYNIX/ptx 


shmid is not a valid shared memory identifier. 


emd is not a valid command. & 


cmd is equal to IPC_RMID or IPC_SET and the effective 
user ID of the calling process is not equal to that of super 
user, or to the value of shm_perm.cuid or 
shm_perm.uid in the data structure associated with 
shmid. 


emd is equal to SHM_LOCK or SHM_UNLOCK and the effec- 
tive user ID of the calling process is not equal to that of 
super user. 


shmget(2), shmop(2) 


DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 


NOTES 


The user must explicitly remove shared memory segments after the last refer- 
ence to them has been removed. 
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NAME 


© SYNOPSIS 


shmget — get shared memory segment identifier 


finclude <sys/types.h> 
#include <sys/ipc.h> 


‘#include <sys/shm.h> 


int shmget (key, size, shmfig) 
key_t key; 
int size, shmfig; 


DESCRIPTION 
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shmget returns the shared memory identifier associated with key. 
Ashared memory identifier and associated data structure and shared memory 
segment of at least size bytes (see intro(2)) are created for key if one of the 
following are true: 
key is equal to IPC_PRIVATE. 
key does not already have a shared memory identifier associated with 
it, and (shmfig & IPC_CREAT) is true. 
Upon creation, the data structure associated with the new shared memory 
identifier is initialized as follows: 
Shm_perm.cuid, shm_perm.uid, shm_perm.cgid, and 
shm_perm.gid are set equal to the effective user ID and effective 
group ID, respectively, of the calling process. 


The low-order 9 bits of shm_perm.mode are set equal to the low- 
order 9 bits of shmflg. Shm_segsz is set equal to the value of size. 


Shm_Ipid, shm_nattch, shm_atime, and shm_dtime are set equal 
to 0. 


Shm_ctime is set equal to the current time. 
shmget fails if any of the following are true: 


[EACCES] Ashared memory identifier exists for key but operation permis- 
sion (see intro(2)) as specified by the low-order 9 bits of shmfilg 
would not be granted. 


[EEXIST] Ashared memory identifier exists for key but ((shmfig & 
IPC_CREAT) and (shmfig & IPC_EXCL)) is true. 

[EINVAL] size is less than the system-imposed minimum or greater than 
the system-imposed maximum. 

[EINVAL] Ashared memory identifier exists for key but the size of the 


segment associated with it is less than size and size is not 
equal to zero. 


[ENOENT] Ashared memory identifier does not exist for key and (shmflg 
& IPC_CREAT) is false. 


[ENOMEM] Ashared memory identifier and associated shared memory seg- 
ment are to be created but the amount of available memory is 
not sufficient to fill the request. 
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[ENOSPC] Ashared memory identifier is to be created but the system- 
imposed limit on the maximum number of allowed shared mem- 
ory identifiers system wide would be exceeded. 


SEE ALSO 
intro(2), shmctl(2), shmop(2) 


DIAGNOSTICS 
Upon successful completion, a non-negative integer, namely a shared memory 
identifier is returned. Otherwise, a value of —1 is returned and errno is set to 


indicate the error. 


NOTES 
The user must explicitly remove shared memory segments after the last refer- 


ence to them has been removed. 
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NAME 


SHMOP(2) 


© shmop, shmat, shmdt — shared memory operations 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/ipc.h> 
#include <sys/shm.h> 


char *shmat (shmid, shmaddr, shmflg) 


int shmid; 


char *shmaddr; 


int shmfig; 


int shmdt (shmaddr) 
char *shmaddr; 


DESCRIPTION 


shmat attaches the shared memory segment associated with the shared mem- 
ory identifier specified by shmid to the data segment of the calling process. 
The segment is attached at the address specified by one of the following cri- 


teria: 


If shmaddr is equal to zero, the segment is attached at the first avail- 
able address as selected by the system. 

If shmaddr is not equal to zero and (shmflg & SHM_RND) is true, the 
segment is attached at the address given by (shmaddr - (shmaddr 
modulus SHMLBA)). 


@& If shmaddr is not equal to zero and (shmfig & SHM_RND)is false, the 
segment is attached at the address given by shmaddr. 


shmdt detaches from the calling process’s data segment the shared memory 
segment located at the address specified by shmaddr. 

The segment is attached for reading if (shmflg & SHM_RDONLY) is true 
{READ}, otherwise it is attached for reading and writing (READ/WRITE). 
shmat fails and does not attach the shared memory segment if one or more of 
the following are true: 


[EACCES] 


[EINVAL] 
[EINVAL] 


[EINVAL] 


[EINVAL] 


[EMFILE] 


@ [ENOMEM] 
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Operation permission is denied to the calling process [see 
intro(2)]. 

shmid is not a valid shared memory identifier. 

shmaddr is not equal to zero, and the value of (shmaddr - 
(shmaddr modulus SHMLBA)) is an illegal address. 


shmaddr is not equal to zero, (shmflg & SHM_RND) is false, 

and the value of shmaddr is an illegal address. 

shmdt fails and does not detach the shared memory segment 
if shmaddr is not the data segment start address of a shared 
memory segment. 

The number of shared memory segments attached to the cal- 

ling process would exceed the system-imposed limit. 

The available data space is not large enough to accommodate 
the shared memory segment. 


’ 
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SEE ALSO ; 
exec(2), exit(2), fork(2), intro(2), shmetl(2), shmget(2) 


DIAGNOSTICS 
Upon successful completion, the return values are as follows: 


shmat returns the data segment start address of the attached shared 
memory segment. 


shmdt returns a value of 0. 
Otherwise, a value of —1 is returned and errno is set to indicate the error. 


NOTES 
The user must explicitly remove shared memory segments after the last refer- 
ence to them has been removed. 
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NAME 


sigaction — examine and change signal actions 


SYNOPSIS 


#include <signal.h> 

int sigaction (sig, act, oact) 
int sig; 

struct sigaction *act, *oact; 


DESCRIPTION 
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The sigaction function allows the calling process to examine or specify (or 
both) the action to be associated with a specific signal. The argument sig 
specifies the signal; acceptable values are defined in <signal.h>. 


The structure sigaction, used to describe an action to be taken, is defined in 
<signal.h> to include following members: 


Member Member Description 
Type Name 


void(*X) sa_handler SIG_DFL, SIG_IGN, or pointer to a function 

sigset_t sa_mask Additional set of signals to be blocked 
during execution of signal-catching 
function. 

int sa_flags Special flags to affect behavior of signal 


If act is not NULL, it points to a structure specifying the action to be associ- 
ated with the specified signal. If oact is not NULL, the action previously 
associated with the signal is stored in the location pointed to by the argument 
oact. If act is NULL, signal handling is unchanged by this function call; thus, 
the call can be used to inquire about the current handling of a given signal. 
The sa_handler field of the sigaction structure identifies the action to be 
associated with the specified signal. If the sa_handler field specifies a signal- 
catching function, the sa_mask field identifies a set of signals that are added 
to the process’s signal mask before the signal-catching function is invoked. 
The SIGKILL and SIGSTOP signals are not added to the signal mask using this 
mechanism; this restriction is enforced by the system without causing an 
error to be indicated. 


The sa_flags field can be used to modify the behavior of the specified signal. 


The flag bit SA_NOCLDSTOP (symbolic constant), defined in <signal.h>, can be 
set in sa_flags to prevent SIGCHLD from being generated when children stop. 


If sig is SIGCHLD and the SA_LNOCLDSTOP fiag is not set in sa_flags, a SIGCHLD 
signal is generated for the calling process whenever any of its child processes 
stop. If sig is SIGCHLD and the SA_NOCLDSTOF flag is set in sa_flags, a 
SIGCHLD signal is not generated in this way. 


When a signal is caught by a signal-catching function installed by sigaction, 
a new signal mask is calculated and installed for the duration of the signal- 
catching function (or until a call to either sigprocmask or sigsuspend). 
This mask is formed by taking the union of the current signal mask and the 
value of the sa_mask for the signal being delivered, and then including the 
signal being delivered. If and when the user’s signal handler returns 
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normally, the original signal mask is restored. 

Once an action is installed for a specific signal, it remains installed until 
another action is explicitly requested (by another call to sigaction), or until 
one of the exec functions is called. 

If the previous action for sig had been established by the signal(2) function, 
the values of the fields returned in the structure pointed to by oact are 
unspecified, and in particular oact->sv_handler is not necessarily the same 
value passed to signal function. However, if pointer to the same structure 
or a copy thereof is passed to a subsequent call to sigaction via the act argu- 
ment, handling of the signal is as if the original call to signal were repeated. 


If sigaction function fails, no new signal handler is installed. 

On successful completion, a value of zero is returned. Otherwise, a value of -1 
js returned and errno is set to indicate the error. 

If the following condition occurs, sigaction returns -1 and sets errno to the 
corresponding value: 


[EINVAL] The value of the sig argument is an invalid or unsupported sig- 
nal number, or an attempt was made to catch a signal that can- 
not be caught or to ignore a signal that cannot be ignored. Refer 
to <signal.h>. 


[EFAULT] _ act or oact points outside the allocated address space. 


SEE ALSO 
kill(1), sigprocmask(2), sigsuspend(2) 


2 12/89 


DYNIX/ptx SIGEMPTYSET(2) 


NAME 


sigemptyset, sigfillset, sigaddset, sigdelset, sigismember — manipulate signal 
sets 


SYNOPSIS 


#include <signal.h> 


int sigemptyset (set) 
sigset_t *set; 

int sigfillset (set) 
sigset_t *set; 

int sigaddset (set,signo) 
sigset_t *set; 

int signo; 

int sigdelset (set, signo) 
sigset_t *set; 

int signo; 

int sigismember (set, signo) 
sigset_t *set; 

int signo; 


DESCRIPTION 
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The sigsetops primitives manipulate sets of signals. They operate on data 
objects addressable by the application, not on any set of signals known to the 
system, such as the set blocked from delivery to a process or the set pending 
for a process. 


The sigemptyset function initializes the signal set pointed to by set, such 
that all signals defined in this standard are excluded. 


The sigfillset function initializes the signal set pointed to by set, such that all 
signals defines in this standard are included. 


Applications call either sigemptyset or sigfillset at least once for each object 
of type sigset_t prior to any other object. If such an object is not initialized in 
this way, but is supplied as an argument to any of the sigaddset, sigdelset, 
sigismember, sigaction, sigprocmask, sigpending, or sigsuspend func- 
tions, the results are undefined. 

The sigaddset and sigdelset functions respectively add and delete the indi- 
vidual signal specified by the value of signo from the signal set pointed to by 
the argument set. 


The sigismember function tests whether the signal specified by the value of 
signo is a member of the set pointed to by the argument set. 


On successful completion, sigismember function returns a value of one if the 
specified signal is a member of the specified set, or a value of zero if it is not. 
On successful completion, the other functions return a value of zero. If an 
error is detected for any of the above functions, a value of -1 is returned and 
errno is set to indicate the error. 


If the following condition is detected, sigaddset, sigelset, and sigismember 
return -1 and set errno to the corresponding value: 
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[EINVAL] The value of signo is an invalid or unsupported signal number. 


SEE ALSO @ 
sigaction(2), sigpending(2), sigprocmask(2), sigsupend(2) 
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NAME 


SIGNAL(2) 


signal — specify what to do upon receipt of a signal 
SYNOPSIS 


#include <signal.h> 


void (*signal (sig, func))() 


int sig; 
void (*func)(); 


DESCRIPTION 
signal allows the calling process to choose one of three ways in which it is pos- 
sible to handle the receipt of a specific signal. sig specifies the signal and func 
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specifies the choice. 


sig can be assigned any one of the following except SIGKILL (the number in 
brackets corresponds to the number of the note below-see NOTES): 


SIGHUP 01 


SIGINT 02 

SIGQUIT 0311) 
SIGILL 0411) 
SIGTRAP 0511) 
SIGIOT 0611) 


SIGABRT 0611) 
SIGEMT 0711) 


SIGFPE 0811) 
SIGKILL 09 

SIGBUS 10[1) 
SIGSEGV 11m) 
SIGSYS 12(1) 


SIGPIPE 13 
SIGALRM 14 
SIGTERM 15 
SIGUSRI1 16 
SIGUSR2 17 
SIGCLD 18(2) 
SIGPWR 19[2) 
SIGWINCH = 2012) 
SIGPOLL 22[3) 
SIGSTOP 23[4) 
SIGTSTP 24[4) 
SIGCONT 25(5) 
SIGTTIN 26(4) 
SIGTTOU 274) 


hangup 

interrupt 

quit 

illegal instruction (not reset when caught) 
trace trap (not reset when caught) 
IOT instruction 

abort and dump core 

EMT instruction 

floatingpoint exception 

kill (cannot be caught or ignored) 
bus error 

segmentation violation 

bad argument to system call 

write on a pipe with no one to read it 
alarm clock 

software termination signal 
user-defined signal 1 

user-defined signal 2 

death of a child 

power fail 

window change 

selectable event pending 

stop process(cannot be caught or ignored) 
interactive stop signal 

continue process 

input from background 

output from background 


func is assigned one of three values: SIG_DFL, SIG_IGN, or a function 
address. SIG_DFL and SIG_IGN are defined in the include file <signal.h>. 
Each is a macro that expands to a constant expression of type pointer to func- 
tion returning void, and has a unique value that matches no declarable func- 


tion. 


The actions prescribed by the values of func are as follows: 
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SIG_DFL — terminate process upon receipt of a signal 
Upon receipt of the signal sig, the receiving process is to be ter- 
minated with all of the consequences outlined in exit(2). See NOTE 
[1] below. 


SIG_IGN — ignore signal 
The signal sig is to be ignored. Note that the signal SIGKILL can- 
not be ignored. 


function address — catch signal 
Upon receipt of the signal sig, the receiving process is to execute 
the signal-catching function pointed to by fune. The signal num- 
ber sig is passed as the only argument to the signal-catching func- 
tion. Additional arguments are passed to the signal-catching func- 
tion for hardware-generated signals. Before entering the signal- 
catching function, the value of func for the caught signal is set to 
SIG_DFL unless the signal is SIGILL, SIGTRAP, or SIGPWR. 


Upon return from the signal-catching function, the receiving pro- 
cess resumes execution at the point it was interrupted. 


When a signal that is to be caught occurs during a read(2), a 
write(2), an open(2), or an ioctl(2) system call on a slow device 
(ike a terminal; but not a file), during a pause(2) system call, or 
during a wait(2) system call that does not return immediately due 
to the existence of a previously stopped or zombie process, the sig- 
nal catching function will be executed and then the interrupted 
system call may return a —1 to the calling process with errno set 
to EINTR. 
signal will not catch an invalid function argument, func, and 
results are undefined when an attempt is made to execute the func- 
tion at the bad address. 
Note that the signal SIGKILL cannot be caught. 
Acall to signal cancels a pending signal sig except for a pending SIGKILL sig- 
nal. 
signal fails if sig is an illegal signal number, including SIGKILL. [EINVAL] 
NOTES 
[1] IfSIG_DFL is assigned for these signals, in addition to the process being « 
terminated, a core image is constructed in the current working directory 
of the process, if the following conditions are met: 
The effective user ID and the real user ID of the receiving process 
are equal. 
An ordinary file named core exists and is writable or can be 
created. If the file must be created, it will have the following pro- 
perties: 
a mode of 0666 modified by the file creation mask [see 
umask(2)] 
a file owner ID that is the same as the effective user ID 
of the receiving process. 
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a file group ID that is the same as the group ID of the 
directory in which the file is created. 


[2] For the signals SIGCLD and SIGPWR, func is assigned one of three values: 
SIG_DFL, SIG_IGN, or a function address. The actions prescribed by 
these values are: 


SIG_DFL - ignore signal 
The signal is to be ignored. 

SIG_IGN - ignore signal 
The signal is to be ignored. Also, if sig is SIGCLD, the calling 
process’s child processes will not create zombie processes when 
they terminate (see exit(2)). 

function address - catch signal 
If the signal is SIGPWR, the action to be taken is the same as 
that described above for func equal to function address. 
The same is true if the signal is SIGCLD with one exception: 
while the process is executing the signal-catching function, any 
received SIGCLD signals are ignored. (This is the default 
action.) 


In addition, SIGCLD affects the wait, and exit system calls as follows: 


wait Ifthe func value of SIGCLD is set to SIG_IGN and a wait is 
executed, the wait blocks until all of the calling process’s child 
processes terminate; it then returns a value of -1 with errno 
set to ECHILD. 


exit If in the exiting process’s parent process the func value of 
SIGCLD is set to SIG_IGN, the exiting process wil] not create a 
zombie process. 


When processing a pipeline, the shell makes the last process in the 
pipeline the parent of the proceeding processes. A process that may be 
piped into in this manner (and thus become the parent of other 
processes) should take care not to set SIGCLD to be caught. 


[8] SIGPOLL is issued when a file descriptor corresponding to a STREAMS [see 
intro(2)] file has a selectable event pending. A process must specifically 
request that this signal be sent using the I_SETSIG ioctl call. Otherwise, 
the process will never receive SIGPOLL. 


[4] The default action for these signal is to stop the process. When any of 
these stop signals are generated for a process, a pending SIGCONT is dis- 
carded. 

[5] The action for SIGCONT is to continue the process if it is currently 
stopped, otherwise the signal is ignored, even if SIGCONT is being blocked 
or ignored. Pending stop signals are discarded. 

SEE ALSO 
kill(1), intro(2), kill(2), pause(2), ptrace(2), wait(2), sigset(2), setimp(3C), 
sigcontext(2seq) 

DIAGNOSTICS 

Upon successful completion, signal returns the previous value of func for the 

specified signal sig. Otherwise, a value of SIG_ERR is returned and errno is 
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set to indicate the error. SIG_ERR is defined in the include file <signal.h>. 
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NAME 

sigpending — examine pending signals 
SYNOPSIS 

#include <signal.h> 

int sigpending (set) 

sigset_t *set; 


DESCRIPTION 
The sigpending function stores the set of signals that are blocked from deliv- 
ery and pending for the calling process, in the space pointed to by set. 


sigpending will fail if the following is true: 


[EFAULT] set points to an illegal address. 
SEE ALSO 

sigprocmask(2), sigemptyset(2), sigaddset(2), sigdelset(2) 
DIAGNOSTICS 


On successful completion, a value of zero is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 
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NAME 
© sigprocmask — examine and change blocked signals 
SYNOPSIS 
#include <signal.h> 
int sigprocmask (how, set, oset) 
int how; 
sigset_t *set, *oset; 
DESCRIPTION 
The sigprocmask function is used to examine or change (or both) the calling 
process’s signal mask. If the value of set is not NULL, it points to a set of sig- 
nals to be used to change the currently blocked set. 
The value of how indicates the manner in which the set is changed, and con- 
sists of one of the following values, as defined in the header <signal.h>: 
SIG_BLOCK The resulting set shall be the union of the current set and 
the signal set pointed to by set. 
SIG_UNBLOCK The resulting set shall be the intersection of the current set 
and the complement of the signal set pointed to by set. 
SIG_SETMASK The resulting set shall be the signal set pointed to by the 
argument set. 
If oset is not. NULL, the previous mask is stored in the space pointed to by 
oset. If the value of set is NULL, the value of how is not significant and the 
process’s signal mask is unchanged by this function call; thus, the call can be 
a) used to inquire about currently blocked signals. 
If there are any pending unblocked signals after the call to sigprocmask, at 
least one of those signals is delivered before sigprocmask returns. 
It is possible to block the SIGKILL and SIGSTOP signals; this is enforced by 
the system without causing an error to be indicated. 
If any of the SIGFPE, SIGLL or SIGSEGV signals are generated while they 
are blocked, the result is undefined, unless the signal was generated by a call 
to the kill function. 
If sigprocmask fails, the process’s signal mask is not changed by this func- 
tion call. 
On sucessful completion, a value of zero is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


If the following condition occurs, sigprocmask returns -1 and sets errno to 


the corresponding value: 
[EINVAL] | The value of how is not equal to one of the defined values. 
SEE ALSO 


sigaction(2), sigpending(2), sigsuspend(2) 
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NAME 


sigset, sighold, sigrelse, sigignore, sigpause — signal management 


SYNOPSIS 


#include <signal.h> 

void (*sigset (sig, func))( ) 
int sig; 

void (*func)( ); 


int sighold (sig) 
int sig; 

int sigrelse (sig) 
int sig; 

int sigignore (sig) 
int sig; 

int sigpause (sig) 
int sig; 


DESCRIPTION 
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These functions provide signal management for application processes. sigset 
specifies the system signal action to be taken upon receipt of signal sig. This 
action is either calling a process signal-catching handler func or performing a 
system-defined action. 


sig can be assigned any one of the following values except SIGKILL. Each 
value of sig is a macro, defined in <signal.h>, that expands to an integer con- 
stant expression. 


SIGHUP hangup 

SIGINT interrupt 

SIGQUIT* quit 

SIGILL* illegal instruction 

SIGTRAP* trace trap 

SIGABRT* abort 

SIGEMT* emulator trap (not set by this system) 
SIGFPE* floatingpoint exception 

SIGKILL kill (can not be caught or ignored) 
SIGBUS* Bus fault (set by this system for an NMI in I/O space) 
SIGSEGV* memory protection fault. 

SIGSYS* bad argument to system call 

SIGPIPE write on a pipe with no one to read it 
SIGALRM alarm clock 

SIGTERM software termination signal 

SIGUSRI1 user-defined signal 1 

SIGUSR2 user-defined signal 2 

SIGCLD death of a child (see WARNING below) 
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SIGPWR power fail (see WARNING below) 

SIGWINCH window size change (see termio(7)) 

SIGPOLL selectable event pending (see NOTES below) 
SIGSTOP stop a process (not set by the system) 

SIGTSTP the tty sub-system requests the process to stop. 
SIGCONT continue a stopped process. 

SIGTTIN the tty sub-system requests stopping on input. 
SIGTTOU the tty sub-system requests stopping on output. 


See below under SIG_DFL regarding asterisks (*) in the above list. 


The following values for the system-defined actions of func are also defined in 
<signal.h>. Each is a macro that expands to a constant expression of type 
pointer to function returning void and has a unique value that matches no 
declarable function. 


SIG_DFL — default system action 
Upon receipt of the signal sig, the receiving process is to be ter- 
minated with all of the consequences outlined in exit(2). In addi- 
tion a core image is made in the current working directory of the 
receiving process if sig is one for which an asterisk appears in the 
above list and the following conditions are met: 


The effective user ID and the real user ID of the receiving 
process are equal. 
An ordinary file named core exists and is writable or can 
be created. Ifthe file must be created, it will have the fol- 
lowing properties: 
a mode of 0666 modified by the file creation mask 
(see umask(2)) 


a file owner ID that is the same as the effective 
user ID of the receiving process. 


a file group ID that is the same as the group ID of 
the directory in which the file is created. 


SIG_IGN — ignore signal 
Any pending signal sig is discarded and the system signal action is 
set to ignore future occurrences of this signal type. 


SIG_HOLD -— hold signal 
The signal sig is to be held upon receipt. Any pending signal of this 
type remains held. Only one signal of each type is held. 


Otherwise, fune must be a pointer to a function, the signal-catching handler, 
that is to be called when signal sig occurs. In this case, sigset specifies that 
the process will call this function upon receipt of signal sig. Any pending sig- 
nal of this type is released. This handler address is retained across calls to the 
other signal management functions listed here. 


When a signal occurs, the signal number sig is passed as the only argument 
to the signal-catching handler. Before calling the signal-catching handler, the 
system signal action is set to SIG_HOLD. During normal return from the sig- 
nal-catching handler, the system signal action is restored to fune and any 
held signal of this type released. If a non-local goto (longjmp) is taken, then 
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sigrelse must be called to restore the system signal action and release any 
held signal of this type. 


In general, upon return from the signal-catching handler, the receiving pro- 
cess will resume execution at the point it was interrupted. However, when a 
signal is caught during a read(2), a write(2), an open(2), or an ioctl(2) sys- 
tem call during a sigpause system call, or during a wait(2) system call that 
does not return immediately due to the existence of a previously stopped or 
zombie process, the signal-catching handler is executed and then the inter- 
rupted system call may return a—I to the calling process with errno set to 
EINTR. 


sighold and sigrelse are used to establish critical regions of code. sighold is 
analogous to raising the priority level and deferring or holding a signal until 
the priority is lowered by sigrelse. sigrelse restores the system signal action 
to that specified previously by sigset. 


sigignore sets the action for signal sig to SIG_IGN (see above). 


sigpause suspends the calling process until it receives a signal, the same as 
pause(2). However, if the signal sig had been received and held, it is released 
and the system signal action taken. This system call is useful for testing vari- 
ables that are changed on the occurrence of a signal. The correct usage is to 
use sighold to block the signal first, then test the variables. If they have not 
changed, then call sigpause to wait for the signal. sigset fails if one or more 
of the following are true: 


[EINVAL] sig is an illegal signal number (including SIGKILL) or the 
default handling of sig cannot be changed. 
(EINTR] A signal was caught during the system call 
DIAGNOSTICS 


Upon successful completion, sigset returns the previous value of the system 
signal action for the specified signal sig. Otherwise, a value of SIG_ERR is 
returned and errno is set to indicate the error. SIG_ERR is defined in <sig- 
nal.h>. 


For the other functions, upon successful completion, a value of 0 is returned. 
Otherwise, a value of —1 is returned and errno is set to indicate the error. 


. SEE ALSO . 


kill(2), pause(2), signal(2), wait(2), setjmp(3C) 


WARNINGS 
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Three signals that behave differently from the signals described above exist in 
this release of the operating system: 

SIGCLD death of a child 

SIGPWR power fail 

SIGCONT continue process 
For these signals, func is assigned one of three values: SIG_DFL, SIG_IGN, or 
a function address. The actions prescribed by these values are as follows: 

SIG_DFL - ignore signal 
The signal is to be ignored. 
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NOTES 


SIG_IGN - ignore signal 
The signal is to be ignored. Also, if sig is SIGCLD, the calling pro- 
cess’s child processes will not create zombie processes when they 
terminate (see exit(2)). 


function address - catch signal 
If the signal is SIGPWR, the action to be taken is the same as that 
described above for func equal to function address. The same is 
true if the signal is SIGCLD with one exception: while the process is 
executing the signal-catching function, any received SIGCLD sig- 
nals is ignored. (This is the default action.) 


SIGCLD affects two other system calls wait(2), and exit(2), in the following 

ways: 

wait Ifthe func value of SIGCLD is set to SIG_IGN and a wait is exe- 
cuted, the wait blocks until all of the calling process’s child 
processes terminate; and then returns a value of —1 with errno set 
to ECHILD. 


exit If in the exiting process’s parent process the func value of SIGCLD 
is set to SIG_IGN, the exiting process will not create a zombie pro- 
cess. 


When processing a pipeline, the shell makes the last process in the pipeline 
the parent of the proceeding processes. A process that may be piped into in 
this manner (and thus become the parent of other processes) should take 
care not to set SIGCLD to be caught. 


SIGPOLL is issued when a file descriptor corresponding to a STREAMS (see 
intro(2)) file has a selectable event pending. A process must specifically 
request that this signal be sent using the I_SETSIG ioctl(2) call (see 
streamio(7)). Otherwise, the process never receives SIGPOLL. 


For portability, applications should use only the symbolic names of signals 
rather than their values and use only the set of signals defined here. The 
action for the signal SIGKILL can not be changed from the default system 
action. 


Also, additional information is available to the signal-catching handler for 
hardware-generated signals by using sigcontext(2seq). For certain hard- 
ware-generated signals, it may not be possible to resume execution at the 
point of interruption. 

The signal type SIGSEGV is reserved for the condition that occurs on an inva- 
lid access to a data object. 


The other signal management functions, signal(2) and pause(2), should not 
be used in conjunction with these routines for a particular signal type. 


12/89 


DYNIX/ptx SIGSUSPEND(2) 


NAME 


sigsuspend — wait for a signal 


SYNOPSIS 


#include <signal.h> 


int sigsuspend (sigmask) 
sigset_t *sigmask; 


DESCRIPTION 


The sigsuspend function replaces the process’s signal mask with the set of 
signals pointed to by sigmask, and then suspends the process until delivery of 
a signal whose action is either to execute a signal-catching function or to ter- 
minate the process. 


If the action is to terminate the process, sigsuspend does not return. If the 
action is to execute a signal-catching function, sigsuspend returns after the 
signal-catching function returns, with the signal mask restored to the set that 
existed prior to the sigsuspend call. 


It is not possible to block signals that cannot be ignored, as documented in 
<signal.h>; this is enforced by the system without causing an error to be indi- 
cated. 


Since sigsuspend suspends process execution indefinitely, there is no suc- 
cessful completion return value. A value of -1 is returned and errno is set to 
indicate the error. 


If the following condition occurs, sigsuspend returns -1 and sets errno to the 
corresponding value: 


[EINTR] A signal is caught process and control is returned from the sig- 
nal-catching function. 


SEE ALSO 
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pause(2), sigaction(2), sigpending(2), sigprocmask(2) 
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NAME 
& stat, Istat, fatat — get file status 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/stat.h> 


int stat (path, buf) 
char *path; 

struct stat *buf; 

int Istat (path, buf) 
char *path; 

struct stat *buf; 

int fstat (fildes, buf) 
int fildes; 

struct stat *buf; 


DESCRIPTION 
path points to a pathname naming a file. Read, write, or execute permission 
of the named file is not required, but all directories listed in the pathname 
leading to the file must be searchable. stat obtains information about the 
named file. 


Istat is like stat except in the case where the named file is a symbolic link, in 
which case Istat returns information about the link, while stat returns infor- 
mation about the file the link references. 


buf is a pointer to a stat structure into which information is placed concern- 
ing the file or symbolic link. 


fetat obtains information about an open file known by the file descriptor 
fildes, obtained from a successful open, creat, dup, fentl, or pipe system 


call. 
buf is a pointer to a stat structure into which information is placed concern- 
ing the file. 
The contents of the structure pointed to by buf include the following mem- 
bers: 
ushortst_mode; /* File mode [see mknod (2)] */ 
ino_t st_ino; /* Inode number */ 
dev_t st_dev; - /* ID of device containing */ 
/* a directory entry for this file */ 
dev_t st_rdev; /* ID of device */ 
/* This entry is defined only for */ 
/* character special or block special files */ 
short st_nlink; /* Number of links */ 
uid_t st_uid; /* User ID of the file’s owner */ 
gid_t st_gid; /* Group ID of the file’s group */ 
off _t st_size; /* File size in bytes */ 
timeval_t st_atimeval; /* Time of last access */ 
timeval t st_mtimeval; /* Time of last data modification */ 
& timeval t st_ctimeval; /* Time of last file status change */ 
/* Times measured in microseconds since */ 
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/* 00:00:00 UTC, Jan. 1, 1970 */ 


#define st_atime st_atimeval.tv_sec 

/* last access time in seconds */ 
#define st_mtime st_mtimeval.tv_sec 

/* last modify time in seconds */ 
#define st_ctime st_ctimeval.tv_sec 


/* last change time in seconds */ 
st_mode The mode of the file as described in the mknod(2) system call. 


st_ino This field uniquely identifies the file in a given filesystem. The 
pair st_ino and st_dev uniquely identifies regular files. 
st_dev This field uniquely identifies the filesystem that contains the 


file. Its value may be used as input to the ustat(2) system call 
to determine more information about this filesystem. No other 
meaning is associated with this value. 

st_rdev This field should be used only by administrative commands. It 
is valid only for block special or character special files and only 
has meaning on the system where the file was configured. 


st_nlink This field should be used only by administrative commands. 


st_uid The user ID of the file’s owner. 
st_gid The group ID of the file’s group. 
st_size For regular files, this is the address of the end of the file. For 


pipes or fifos, this is the count of the data currently in the file. 
For block special or character special, this is not defined. 


st_atimeval ‘Time in seconds and microseconds when file data was last 
accessed. Changed by the following system calls: creat(2), 
exec(2), open(2), mkdir(2), mknod(2), pipe(2), utime(2), and 
read(2). 


st_atime Contains the time_t(seconds) portion of st_atimeval. 


st_mtimeval Time in seconds and microseconds when data was last modi- 
fied. Changed by the following system calls: creat(2), open(2), 
link(2), unlink(2), mkdir(2), rmdir(2), rename(2), 
mknod(2), pipe(2), utime(2), and write(2). 

st_mtime Contains the time_t(seconds) portion of st_mtimeval. 

st_ctimeval Time in seconds and microseconds when file status was last 
changed. Changed by the following system calls: chmod(2), 
chown(2), creat(2), open(2), link(2), mkdir(2), rmdir(2), 
rename(2), mknod(2), pipe(2), unlink(2), utime(2), and 


write(2). 
st_ctime Contains the time_t(seconds) portion of st_ctimeval. 
stat and Istat fail if any of the following are true: 
[EACCES] Search permission is denied for a component of the path 
prefix. : 
[EFAULT] buf or path points to an invalid address. 
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(EIO] 


© [ELOOP] 


[ENAMETOOLONG] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 


([ENOENT] 
(ENOTDIR] 


STAT(2) 


An I/O error occurred while reading from or writing to 
the file system. 


Too many symbolic links were encountered in translat- 
ing path. 


path was longer than PATH_MAX characters. 


Path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


The named file does not exist. 
Acomponent of the path prefix is not a directory. 


fstat fails if any of the following are true: 


(EBADF] 
(EFAULT] 
[EIO] 


SEE ALSO 


fildes is not a valid open file descriptor. 
buf points to an invalid address. 


An I/O error occurred while reading from or writing to 
the file system. 


chmod(2), chown(2), creat(2), link(2), mknod(2), pipe(2), read(2), time(2), 
unlink(2), utime(2), write(2) 


DIAGNOSTICS 
Upon successful completion a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 
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NAME 


@ SYNOPSIS 


statfs, fstatfs — get filesystem information 


#include <sys/types.h> 
#include <sys/statfs.h> 


int statfs (path, buf, len, fstyp) 
char *path; 

struct statfs «buf; 

int len, fstyp; 

int fstatfs (fildes, buf, len, fstyp) 
int fildes; 

struct statfs *buf; 

int len, fstyp; 


DESCRIPTION 
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statfs returns a generic superblock describing a filesystem. It can be used to 
acquire information about mounted as well as unmounted filesystems, and 
usage is slightly different in the two cases. In all cases, buf is a pointer toa 
structure (described below) which will be filled by the system call, and len is 
the number of bytes of information which the system should return in the 
structure. len must be no greater than sizeof (struct statfs) and ordinarily 
contains exactly that value; if it holds a smaller value the system fills the 
structure with that number of bytes. (This allows future versions of the sys- 
tem to grow the structure without invalidating older binary programs.) 


If the filesystem of interest is currently mounted, path should name a file 
which resides on that filesystem. In this case the filesystem type is known to 
the operating system and the fstyp argument must be zero. For an 
unmounted filesystem path must name the block special file containing it and 
fstyp must contain the (non-zero) filesystem type. In both cases read, write, 
or execute permission of the named file is not required, but all directories 
listed in the pathname leading to the file must be searchable. 


The statfs structure pointed to by buf includes the following members: 
short f_fstyp; /* Filesystem type */ 
long f_bsize; /* Block size */ 
long f_frsize; /* Fragment size */ 
long f_blocks; /* Total number of blocks */ 
long f_bfree; /* Count of free blocks */ 
long f_files; /* Total number of file nodes */ 
long f_ffree; /* Count of free file nodes */ 
char f_fname[6];/* Volume name */ 
char f_fpack[6];/* Pack name */ 
long f_bavail; /* Block available to non superuser */ 


fstatfs is similar, except that the file named by path in statfs is instead 
identified by an open file descriptor filedes obtained from a successful 
open(2), creat(2), dup(2), fentl(2), or pipe(2) system call. 

statfs obsoletes ustat(2) and should be used in preference to it in new pro- 
grams. 
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statfs and fstatfs fails if one or more of the following are true: 


[EACCES] 


[EBADF} 


[EFAULT] 


[EINVAL] 


[EIO] 


[ELOOP] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


[ENAMETOOLONG] 


{ENOENT] 


DIAGNOSTICS 


Search permission is denied for a component of the path 
prefix. 


fildes is not a valid open file descriptor. 
buf or path points to an invalid address. 


fstyp is an invalid filesystem type; path is not a block 
special file and fstyp is non-zero; len is negative or is 
greater than sizeof (struct statfs). 

An I/O error occurred while reading from or writing to 
the file system. 


Too many symbolic links were encountered in translat- 
ing path. 

path was longer than PATH_MAX characters. 

path referenced a symbolic link which, when expanded, 


resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


The named file does not exist. [ENOTDIR] A component 
of the path prefix is not a directory. 


Upon successful completion a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 


SEE ALSO 


chmod(2), chown(2), creat(2), link(2), mknod(2), pipe(2), read(2), time(2), 
unlink(2), utime(2), write(2), fs(4) 


WARNING 


Certain fields of the statfs structure may refer to attributes of the underlying 
file system that are either unknown or undefined. For example, certain fields 
of the statfs structure may be undefined or unknown for remote file systems. 


Any unknown or undefined numerical fields of the statfs structure are 
returned as—1. Any unknown or undefined character fields are returned with 
all characters set to zero. Application programs must be prepared to handle 


such returns. 
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NAME 
stime — set time 
SYNOPSIS 
int stime (tp) 
long *tp; 
DESCRIPTION 
stime sets the system’s idea of the time and date. tp points to the value of 
time as measured in seconds from 00:00:00 UTC January 1, 1970. 


[EPERM]  stime fails if the effective user ID of the calling process is not 
superuser. 
SEE ALSO 
time(2) 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 


is returned and is set to indicate the error. 
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NAME 


stty, gtty — set and get terminal state (defunct) 


SYNOPSIS 


#include <sgtty.h> 


stty(fd, buf) 
int fd; 
struct sgttyb *buf; 


gtty(fd, buf) 
int fd; 
struct sgttyb *buf; 


DESCRIPTION 


This interface is obsoleted by ioctl(2). 

stty sets the state of the terminal associated with fd. gtty retrieves the state 
of the terminal associated with fd. To set the state of a terminal the call must 
have write permission. 

The stty call is actually ioctl(fd, TIOCSETP, buf), while the gtty call is 
ioctl(fd, TIOCGETP, buf). See ioctl(2) and tty(4) for an explanation. 


DIAGNOSTICS 


If the call is successful 0 is returned, otherwise —1 is returned and the global 
variable errno contains the reason for the failure. 


SEE ALSO 
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ioctl(2), tty(4) 
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NAME 
sync — update superblock 

SYNOPSIS 
void sync ( ) 

DESCRIPTION 
sync causes all information in memory that should be on disk to be written 
out. This includes modified superblocks, modified inodes, and delayed block 
Yo. 
It should be used by programs which examine a filesystem, for example fsck, 
df, etc. It is mandatory before a re-boot. 
The writing, although scheduled, is not necessarily complete upon return from 
sync. 
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NAME 
syscall — indirect system call 

SYNOPSIS 
syscall(number, arg, ...) 

DESCRIPTION 
syscall performs the system call whose assembly language interface has the 
specified number and arguments arg. 
The r0 value of the system call is returned. 

DIAGNOSTICS 
When the C-bit is set, syscall returns —1 and sets the external variable errno 
(see intro(2)). 

BUGS 
Certain system calls, such as brk(2), dup(2), fork(2), pipe(2), signal(2), sig- 
set(2), sigaction(2), vfork(2), wait(2), and waitpid(2), cannot be accessed 
using this interface. These syscalls require extra interface code, which is nor- 
mally provided in the C library entry points. This interface code is not pro- 
vided through the syscall(2) invocation. 


Some syscall numbers differ between DYNIX/ptx and the i386 version of Sys- 
tem V. Programs that do not use the symbolic definitions from <syscall.h> 
may fail when ported to and from other operating systems. 
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NAME 


sysconf — get configurable system variables 


SYNOPSIS 


#include <unistd.h> 


long sysconf (name) 
int name; 


DESCRIPTION 


The sysconf function provides a method for the application to determine the 
current value of a configurable system limit or option (variable). 


The name argument represents the system variable to be queried. The fol- 
lowing system variables are supported: 


Configurable Variables 
Variable name Value 
ARG_MAX 
CHILD_MAX _SC_CHILD_MAX 
CLK_TCK 
NGROUPS_MAX _SC_NGROUPS_MAX 
OPEN_MAX _SC_OPEN_MAX 
_POSIX_JOB_CONTROL _SC_JOB_CONTROL 
_POSIX_SAVED_IDS _SC_SAVED_IDS 
_POSIX_VERSION _SC_VERSION 


These variables come from <limits.h> or <unistd.h>; or from <time.h> , and 
the symbolic constants, defined in <unistd.h>, that are the corresponding val- 
ues used for name. 


The value of CLK_TCK may be evaluated at run-time. The value returned by 
sysconf for _SC_CLK_TCK is the same as that returned by CLK_TCK. 


DIAGNOSTICS 
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If name is an invalid value, sysconf returns -1. If the variable corresponding 
to name is not defined on the system, sysconf returns -1 without changing the 
value of errno. 

Otherwise, sysconf returns the current variable value in the system. The 
value returned is not more restrictive than the corresponding value described 
to the application when it was complied with <limits.h> or <unistd.h>. The 
value does not change during the lifetime of the calling process. 

If the following condition occurs, sysconf returns -1 and sets errno to the cor- 
responding value: 


[EINVAL] The value of the argument is invalid. 


DYNIX/ptx SYSI86(2) 


NAME 

sysi86 — machine specific functions 
SYNOPSIS 

#include <sys/sysi86.h> 


int sysi86 (cmd, argl, arg2, arg3) 
int cmd, argl, arg2, arg3; 
DESCRIPTION ; 
sysi86 implements machine specific functions. The cmd argument deter- 
mines the function performed. The number of arguments expected is depen- 
dent on the function. The values of the cmd arguments are explained in the 
following paragraphs. 
SI86FPHW 
When emd is SI86FPHW, an indication of the floating-point hardware avail- 
able is returned. One argument, the address of an integer, is expected. On 
return from the system call, this integer contains the following values (defined 
in <sys/fp.h>): 
FP_387 indicates that the 80387 chip is present 


WEITEK_HW indicates that the WTL 1167 is present 

SETNAME 
This command, which is only available to the superuser, expects an argument 
of type char* which points to a NULL terminated string of at most 7 charac- 
ters. This command changes the running system’s sysname and nodename 
(see uname(2)) to this string. 

SI86MEM 
This command returns the size of total memory in bytes. 

SI86SWPI 
When emd is SI86SWPI, individual swapping areas may be added or the cur- 
rent areas determined. The address of an appropriately primed swap buffer is 
passed as the only argument. (Refer to the <sys/swap.h > header file for 
details of loading the buffer.) 
The format of the swap buffer is: 


struct swapint { 


char si_cmd; /*command: list, add, delete*/ 
char *si_buf; /*swap file path pointer*/ 

int si_swplo; /*start block (not used)*/ 

int si_nblks; /*swap size*/ 


} 


Note that the add option of the command may only be exercised by the 
superuser. If si_nblks is 0, the entire device is used. si_swplo is not used; it 
is assumed to be always 0. 


If this command succeeds, it returns 0 to the calling process. This command 
fails, returning -1, if any of the following is true: 


[EEXIST] Swap area specified has already been added 
(EFAULT] swapbuf points to an invalid address 
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[EFAULT] swapbuf.si_buf points to an invalid address 
(EINVAL] Bad arguments 

[ENOSPC] Too many swap areas in use (if adding) 
(ENOTBLK] Swap area specified is not a block special device 


STIME 
When emd is STIME, an argument of type time_t is expected. This function 
sets the system time and date. The argument contains the time as measured 
in seconds from 00:00:00 UTC (Universal Time Code) January 1, 1970. Note 
that this command is only available to the superuser. 


SEE ALSO 
swap(1M), uname(2) 

DIAGNOSTICS 
Upon successful completion, the value of zero is returned. Otherwise, a value 
of -1 is returned and errno is set to indicate the error. When cmd is invalid, 
errno is set to EINVAL on return. 
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NAME 


tegetattr, tcsetattr - get/set terminal state 


SYNOPSIS 


#include <termios.h> 


int tcgetattr (fildes, termios_p) 
int _fildes; 
struct termios *termios_p; 


int tcsetattr (fildes, optional_actions, termios p) 
int fildes, optional_actions; 
struct termios *lermios_p; 


DESCRIPTION 


The tegetattr() function gets the parameters associated with the terminal 
referred to by fildes and stores them in the termios structure referrenced by 
termios_p. This function is allowed from a background process; however, the 
terminal attributes may be subsequently changed by a foreground process. 
The tesetattr() function sets the parameters associated with the terminal 
from the termios structure referrenced by termios_p as follows: 


(1) If optional_actions is tesanow() , the change shall occur immediately. 

(2) If optional_actions is tesadrain() , the change shall occur after all out- 
put written to fildes has been transmitted. this function should be 
used when changing parameters that affect output. 

(8) If optional_actions is tesaflush() , the change shall occur after all out- 
put written to the object referred to by fildes has been transmitted, 
and all input that has been received but not read shall be descarded 
before the change is made. 

The symbolic constants for the values of optional_actions are defined in <ter- 

mios.h> 

Upon successful completion, tegetattr() and tcsetattr() will return a value of 

zero. Otherwise, a value of —1 is returned and errno is set to indicate the 

error. 

If any of the following conditions occur, the tegetattr() function shall return 

-1 and set errno to the corresponding value: 

[EBADF] 

The fildes argument is not a valid file descriptor. 
(ENOTTY] 

The file associated with fildes is not a terminal. 

If any of the followin conditions occur, the tesetattr() function shall return -1 

and set errno to the corresponding value: 

[EBADF] 
The fildes argument is not a valid file descriptor. 


[EINVAL] 
Either arg or the data it references is not a proper value. 
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(ENOTTY] 
The file associated with fildes is not a terminal. 


DIAGNOSTICS 
The tesetattr() function is restricted from use by processes belonging to a 
background process group. Attempts to perform this operation shall cause the 
process group to be sent a SIGTTOU signal. If the calling process is blocking or 
ignoring SIGTTOU signals, the process is allowed to perform the operation and 
the SIGTTOU signal is not sent. See the Terminal Access Control section of 
the termio(7) man page for more details. 


NOTES 
The tegetattr() function performs the TCGETP ioctl command. 
Regarding the tesetattr() function: If optional_actions is TCSANOW, the func- 
tion performs the TCSETP command. If optional_actions is TCSADRAIN, the 
function performs the TCSETPW command. If optional_actions is TCSAFLUSH, 
the function performs the TCSETPF command. 
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NAME 


tegetpgrp — get foreground process group ID 


SYNOPSIS 


#include <sys/types.h> 


pid_t tegetpgrp (fildes) 
int fildes; 


DESCRIPTION 


The tegetpgrp function returns the value of the process group ID of the fore- 
ground process group associated with the terminal. 


The tegetpgrp function is allowed from a process that is a member of a back- 
ground-process group; however, the information may be subsequently changed 
by a process that is a member of a foreground-process group. 

On successful completion, tegetpgrp returns the process group ID of the fore- 
ground process group associated with the terminal. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 


Tf any of the following conditions occur, tegetpgrp returns -1 and sets errno 
to the corresponding value: 


[EBADF] The fildes argument is not a valid file descriptor. 


[ENOTTY] The calling process does not have a controlling terminal or the 
file is not the controlling terminal. 


SEE ALSO 
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setsid(2), setpgid(2), tesetpgrp(2) 


DYNIX/ptx TCSETPGRP(2) 


NAME 
tesetpgrp — set foreground process group ID 


SYNOPSIS 
#include <sys/types.h> 


int tesetpgrp (fildes,pgrp_id) 
int fildes; 
pid_t pgrp_id; 

DESCRIPTION 
If the process has a controlling terminal, tesetpgrp sets the foreground pro- 
cess group ID associated with the terminal to pgrp_id. The file associated 
with fildes must be the controlling terminal of the calling process and the 
controlling terminal must be currently associated with the session of the cal- 
ling process. The value of pgrp_id must match a process group ID of a pro- 
cess in the same session as the calling process. 


Upon successful completion, tesetpgrp returns a value of zero. Otherwise, a 
value of -1 is returned and errno is set to indicate the error. 


If any of the following conditions occur, tesetpgrp returns -1 and sets errno 
to the corresponding value: 


[EBADF] The fildes argument is not a valid file descriptor. 


[ENOTTY] The calling process does not have a controlling terminal, or the 
file is not the controlling terminal, or the controlling terminal is 
no longer associated with the session of the calling process. 


(EPERM] The value of pgrp_id is within range , but does not match the 
process group ID of a process in the same session as the calling 
process. 
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NAME 

time — get time 
SYNOPSIS 

#include <sys/types.h> 


time_t time (tloc) 
time_t *tloc; 
DESCRIPTION 
time returns the value of time in seconds since 00:00:00 UTC, January 1, 
1970. 
If tloc is non-zero, the return value is also stored in the location to which tloc 
points. 
SEE ALSO 
stime(2) 
WARNINGS 
time fails and its actions are undefined if tloc points to an illegal address. 
DIAGNOSTICS 
Upon successful completion, time returns the value of time. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
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NAME 


times — get process and child process times 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/times.h> 


clock_t times (buffer) 
struct tms *buffer; 


DESCRIPTION 


times fills the structure pointed to by buffer with time-accounting informa- 
tion. The following are the contents of this structure: 


struct tms { 


clock_t tms_utime; 
clock_t tms_stime; 
clock_t tms_cutime; 
clock_t tms_cstime; 


e 

This information comes from the calling process and each of its terminated 
child processes for which it has executed a wait. All times are reported in 
clock ticks per second. Clock ticks are a system-dependent parameter. The 
specific value for an implementation is defined by the variable HZ, found in 
the include file <sys/param.h>. 


tms_utime is the CPU time used while executing instructions in the user 
space of the calling process. 

tms_stime is the CPU time used by the system on behalf of the calling pro- 
cess. 


tms_cutime is the sum of the tms_utimes and tms_cutimes of the child 
processes. 


tms_cstime is the sum of the tms_stimes and tms_cstimes of the child 
processes. 


SEE ALSO 


exec(2), fork(2), time(1), time(2), wait(2) 


DIAGNOSTICS 
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Upon successful completion, times returns the elapsed real time, in clock 
ticks per second, from an arbitrary point in the past (e.g., system start-up 
time). This point does not change from one invocation of times to another. If 
times fails, a—1 is returned and errno is set to indicate the error. 

[EFAULT] times fails if buffer points to an illegal address. 


On Sequent systems, clock ticks occur 100 times per second. 
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NAME 
uadmin — administrative control 


SYNOPSIS 

#include <sys/boot.h> 

#include <sys/uadmin.h> 

int uadmin (cmd, fen, mdep) 

int cmd, fen, mdep; 

DESCRIPTION 

uadmin provides control for basic administrative functions. This system call 

is tightly coupled to the system administrative procedures and is not intended 

for general use. 

As specified by cmd, the following commands are available: 

A_REBOOT The system stops immediately without any further process- 
ing. The action to be taken next is specified by fen, described 
below. 

A.SHUTDOWN The system is shutdown. All user processes are killed, the 
buffer cache is flushed, and the root file system is unmounted. 
The action to be taken after the system has been shut down is 

» specified by fen. 


AD_HALT Halt the system. 
AD_BOOT Reboot the system, using /unix. 


AD_IBOOT Interactive reboot; user is prompted for system 
name. 


AD_BOOT_NOKILL 
Same as A SHUTDOWN/AD_BOOT, but don’t 
kill user processes. 
The mdep argument is a bitmask of options that affects the actions as follows. 


RB_AUTOBOOT 
This is the default; the system is rebooted 
according to the firmware parameters. 


RB_HALT Halt the system. 


RB_ASKNAME 
Interactive reboot; the bootstrap program 
prompts for the filename to be rebooted. 


RB_NOSYNC Don’t flush the disk buffer cache out to disk 
before shutting down. 


uadmin fails if‘any of the following are true: 
[EPERM] The effective user ID is not superuser. 


DIAGNOSTICS 
Upon successful completion, the value returned depends on cmd as follows: 
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A.SHUTDOWN Never returns. 


A_REBOOT Never returns. & 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 
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NAME 
ulimit — get and set user limits 
SYNOPSIS 

long ulimit (cmd, newlimit) 

int cmd; 

long newlimit; 

DESCRIPTION 

This function provides for control over process limits. The emd values avail- 

able follow. If the value of command is 1, 3, or 4 below (get a current limit), 

newlimit is ignored. 

1. Get the regular file size limit of the process. The limit is in units of 
512-byte blocks and is inherited by child processes. Files of any size can be 
read. 

2. Set the regular file size limit of the process to the value of newlimit. Any 
process may decrease this limit, but only a process with an effective user ID 
of superuser may increase the limit. ulimit fails and the limit is 
unchanged if a process with an effective user ID other than superuser 
attempts to increase its regular file size limit. [EPERM] 

8. Get the maximum possible break value [see brk(2)]. 


4. Get the current value of the maximum number of open files per process 
configured:in the system. 


ulimit fails if any of the following occur: 
(EPERM] The caller was not superuser, and tried to increase it’s file size 


limit. 
[EINVAL] An unsupported value for the cmd argument was used. 
SEE ALSO 
brk(2), write(2) 
WARNINGS 


ulimit is effective in limiting the growth of regular files. Pipes are currently 
limited to 8,192 bytes. 


DIAGNOSTICS 
Upon successful completion, a non-negative value is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
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NAME 
umask — set and get file creation mask 
SYNOPSIS 
#include <sys/types.h> 
mode_t umask (cmask) 
mode_t cmask; 
DESCRIPTION 
umask sets the process’s file mode creation mask to cmask and returns the 
previous value of the mask. Only the low-order 9 bits of emask and the file 
mode creation mask are used. 


SEE ALSO 
mkdir(1), sh(1), chmod(2), creat{2), mknod(2), open(2) 


DIAGNOSTICS 
The previous value of the file mode creation mask is returned. 
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NAME 
& umount — unmount a filesystem 
SYNOPSIS 
int umount (file) 
char *file; 


DESCRIPTION 
umount requests that a previously mounted filesystem contained on the 
block special device or directory identified by file be unmounted. file isa 
pointer to a pathname. After unmounting the filesystem, the directory upon 
which the filesystem was mounted reverts to its ordinary interpretation. 
umount may be invoked only by the superuser. 


umount fails if one or more of the following are true: 


[EBUSY] A file on file is busy. 

(EFAULT] file points to an illegal address. 

[EINVAL] file does not exist. 

[EINVAL] file is not mounted. 

(ENOTBLK] file is not a block special device. 

[EPERM] The process’s effective user ID is not superuser. 
SEE ALSO 

mount(2) 


DIAGNOSTICS 
Upon successful completion a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 
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NAME 


UNAME(2) 


uname — get name of current operating system 


SYNOPSIS 


#include <sys/utsname.h> 


int uname (name) 
struct utsname *name; 


DESCRIPTION 


uname stores information identifying the current operating system in the 
structure pointed to by name. 


uname uses the structure defined in <sys/utsname.h> whose members are: 


char 
char 
char 
char 
char 


sysname [9]; 
nodename (9); 
release[9]; 
version[9]; 
machine[9]; 


uname returns a null-terminated character string naming the current 
operating system in the character array sysname. Similarly, nodename 
contains the name that the system is known by on a communications network. 
release and version further identify the operating system. machine con- 
tains a standard name that identifies the hardware that the operating system 


is running on. 


{EFAULT] uname fails if name points to an invalid address. 


SEE ALSO 
uname(1) 


DIAGNOSTICS 


Upon successful completion, a non-negative value is returned. Otherwise, a 
value of —1 is returned and errno is set to indicate the error. 
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NAME 


UNLINK(2) 


unlink — remove directory entry 


SYNOPSIS 


int unlink (path) 


char *path; 
DESCRIPTION 


unlink removes the directory entry named by the path name pointed to by 


path. 


The named file is unlinked unless one or more of the following are true: 


[EACCES] 
[EACCES] 


(EACCES] 


{EBUSY] 

{EFAULT] 

{EIO] 

{ELOOP] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 
[ENAMETOOLONG] 


(ENOENT] 
(ENOTDIR] 
[EPERM] 


[EROFS] 


(ETXTBSY] 


Search permission is denied for a component of the path 
prefix. 

Write permission is denied on the directory containing 
the link to be removed. 

The parent directory has the sticky bit set and the file is 
not writable by the user and the user does not own the 
parent directory and the user does not own the file and 
the user is not superuser 


The entry to be unlinked is the mount point for a 
mounted file system. 


path points outside the process’s allocated address 
space. 

An I/O error occurred while reading from or writing to 
the file system. 

Too many symbolic links were encountered in translat- 
ing path. 

path was longer than PATH_MAX characters. 


path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


Acomponent of path was longer than NAME_MAX char- 
acters. 


The named file does not exist. 
Acomponent of the path prefix is not a directory. 


The named file is a directory and the effective user ID of 
the process is not superuser. 


The directory entry to be unlinked is part of a read-only 
file system. 


The entry to be unlinked is the last link to a pure proce- 
dure (shared text) file that is being executed. 


When all links to a file have been removed and no process has the file open, 
the space occupied by the file is freed and the file ceases to exist. If one or 
more processes have the file open when the last link is removed, the removal 
is postponed until all references to the file have been closed. 
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SEE ALSO 

rm(1), close(2), link(2), open(2) @ 
DIAGNOSTICS 

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 

is returned and errno is set to indicate the error. 
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NAME 


ustat — get filesystem statistics 


SYNOPSIS 


#include <sys/types.h> 
#include <ustat.h> 


int ustat (dev, buf) 
dev._t dev; 
struct ustat *buf; 


DESCRIPTION 


ustat returns information about a mounted filesystem. dev is a device num- 
ber identifying a device containing a mounted filesystem. buf is a pointer toa 
ustat structure that includes the following elements: 


daddr_t f_tfree; /* Total free blocks */ 
ino_t f_tinode; /* Number of free inodes */ 
char f£_fname[6]; /* Filsys name */ 
char £_fpack[6]; /* Filsys pack name */ 
ustat fails if one or more of the following are true: 
[EFAULT] buf points outside the process’s allocated address space. 
{EINVAL] dev is not the device number of a device containing a 
mounted filesystem. 
SEE ALS 


10) 
stat(2), fa(4) 


DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 


WARNING 
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Certain fields of the ustat structure may refer to attributes of the underlying 
file system that are either unknown or undefined. For example, certain fields 
of the ustat structure may be undefined or unknown for remote file systems. 
Any unknown or undefined numerical fields of the ustat structure are 
returned as—1. Any unknown or undefined character fields are returned with 
all characters set to zero. Application programs must be prepared to handle 
such returns. 


DYNIX/ptx UTIME(2) 


NAME 


utime — set file access and modification times 


SYNOPSIS 


#include <sys/types.h> 
int utime (path, times) 
char *path; 

struct utimbuf *times; 


DESCRIPTION 
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path points to a path name naming a file. utime sets the access and modifi- 
cation times of the named file. 


If times is NULL, the access and modification times of the file are set to the 
current time. A process must be the owner of the file or have write permission 
to use utime in this manner. 


If times is not NULL, times is interpreted as a pointer to a utimbuf struc- 
ture and the access and modification times are set to the values contained in 
the designated structure. Only the owner of the file or the superuser may use 
utime this way. 

The times in the following structure are measured in seconds since 00:00:00 
UTC, Jan. 1, 1970. 


struct utimbuf { 
time_t actime; /* access time */ 
time_t modtime; /* modification time */ 
Me 


utime fails if one or more of the following are true: 


[EACCES] Search permission is denied by a component of the path 
prefix. 

[EACCES] The effective user ID is not superuser and not the owner 
of the file and times is NULL and write access is 
denied. 

[EFAULT] times is not NULL and points outside the process’s allo- 
cated address space. 

[EFAULT] path points outside the process’s allocated address 
space. 

[{EIO] An Y/O error occurred while reading from or writing to 
the file system. 

[ELOOP] Too many symbolic links were encountered in translat- 
ing path. 


[ENAMETOOLONG] path was longer than PATH_MAX characters. 


[ENAMETOOLONG] | path referenced a symbolic link which, when expanded, 
resulted in a path name longer than PATH_MAX charac- 
ters. 


[ENAMETOOLONG] Acomponent of path was longer than NAME_MAX char- 
acters. 
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[ENOENT] The named file does not exist. 
(ENOTDIR] A component of the path prefix is not a directory. & 
(EPERM] The effective user ID is not superuser and not the owner 
of the file and times is not NULL. 
[EROFS] The filesystem containing the file is mounted read-only. 
SEE ALSO 
stat(2) 
DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 
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NAME 


vfork — spawn new process in a virtual memory efficient way 


SYNOPSIS 


#include <sys/types.h> 
pid_t vfork() 


DESCRIPTION 


@ SEE ALSO 


vfork can be used to create new processes without fully copying the address 
space of the old process, which is horrendously inefficient in a paged environ- 
ment. It is useful when the purpose of fork(2) would have been to create a 
new system context for an exec. vfork differs from fork in that the child bor- 
rows the parent’s memory and thread of control until a call to exec(2) or an 
exit (either by a call to exit(2) or abnormally.) The parent process is sus- 
pended while the child is using its resources. 


vfork returns 0 in the child’s context and (later) the pid of the child in the 
parent’s context. 


vfork can normally be used just like fork. It does not work, however, to 
return while running in the child’s context from the procedure which called 
vfork since the eventual return from vfork would then return to a no longer 
existent stack frame. Be careful, also, to call _exit rather than exit if you 
can’t exec, since exit flushes and closes standard I/O channels, and thereby 
messes up the parent process’s standard I/O data structures. (Even with fork 
it is wrong to call exit since buffered data would then be flushed twice.) 


fork(2), exec(2), wait(2) 


DIAGNOSTICS 


BUGS 
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Same as for fork. 


Users should not depend on the memory sharing semantics of vfork as it is an 
artifact of the implementation. 


To avoid a possible deadlock situation, processes which are children in the 
middle of a vfork are never sent SIGTTOU or SIGTTIN signals; rather, out- 
put or ioctls are allowed and input attempts result in an end-of-file indication. 
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NAME 


wait, waitpid — wait for a child process to stop or terminate 


SYNOPSIS 


#include <sys/wait.h> 
#include <sys/types.h> 


pid_t wait (stat_loc) 
int *stat_loc; 


pid_t waitpid (pid, stat_loc, options) 
pid_t pid; 

int *stat_loc; 

int options; 


DESCRIPTION 
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wait and waitpid allow the calling process to obtain status information per- 
taining to one of its child processes. Various options permit status informa- 
tion to be obtained for child processes that have terminated or stopped. If sta- 
tus information is available for two or more child processes, the order in which 
their status is reported is unspecified. 


The wait function suspends execution of the calling process until status infor- 
mation for one of its terminated child processes is available, or unti] delivery 
of a signal whose action is either to execute a signal-catching function or to 
terminate the process. If status information is available prior to the call to 
wait, it returns immediately. 


The waitpid function behaves identically to the wait function, if the pid 
argument has the value —1 and the options argument has a value of zero. 
Otherwise, its behavior is dependent on the values of pid and options. 


The pid argument specifies a set of child processes for which status is 
requested. The waitpid function shall only return the status of a child pro- 
cess from this set. . 
(1) If pid is equal to —-1, status is requested for any child process. In this 
respect, waitpid() is then equivalent to wait(). 
(2) If pid is greater than zero, it specifies the process ID of a single child 
process for which status is requested. 
(3) If pid is equal to zero, status is requested for any child process whose 
process group ID is equal to that of the calling process. 
(4) If pid is less than —1, status is requested for any child process whose pro- 
cess group ID is equal to the absolute value of pid. 

The options argument is constructed the the bitwise inclusive OR of zero or 

more of the following flags, defined in the header <sys/wait.h>: 

WNOHANG The waitpid() function shall not suspend execution of the cal- 
ling process if status is not immediately available for one of the 
child processes specified by pid. 

WUNTRACED The status of any child process specified by pid that are 
stopped, and whose status has not yet been reported since they 
stopped, are also reported. ; 


If stat_loc is non-zero, the requested information called status are stored in 
the location pointed to by stat_loc. status can be used to differentiate 
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between stopped and terminated child processes and if the child process ter- 
minated, status identifies the cause of termination and passes useful informa- 
tion to the parent. This is accomplished by using the following macros, that 
are defined in <sys /wait.h> and evaluate to integral expressions; the stat_val 
argument is the integer value pointed to by stat_loc. 


WIFEXITED(stat_val) 
Evaluates to a non-zero value if status was returned for a child 
process that terminated normally. 


WEXITSTATUS(stat_val) 
If the value of WIFEXITED(stat_val) is non-zero, this macro 
evaluates to the low-order 8 bits of the status argument that 
the child process passed to _exit() or exit(), or the value the 
child process returned from main(). 


WIFSIGNALED(stat_val) 
Evaluates to a non-zero value if the status was returned for a 
child process that terminated due to the receipt of a signal that 
was not caught. 


WTERMSIG(stat_val) 
If the value of WIFSIGNALED(stat_val) is non-zero, this 
macro evaluates to the number of the signal the caused the 
termination of the child process. 


WIFSTOPPED(stat_val) 
Evaluates to a non-zero value if status was returned for a child 
process that is currently stopped. 


WSTOPSIG(stat_val) 
If the value of WIFSTOPPED(stat_val) is non-zero, this macro 
evaluates to the number of the signal the caused the child pro- 
cess to stop. 


WIFCORESIG(stat_val) 
Evaluates to a non-zero value if the status was returned for a 
child process that terminated due to the receipt of a signal that 
was not caught and caused a core dump. 


If a parent process terminates without waiting for its child processes to termi- 
nate, the parent process ID of each child process is set to 1. This means the ini- 
tialization process inherits the child processes (see intro(2)). 


wait fails and returns immediately if any of the following are true: 


[ECHILD] The calling process has no existing unwaited-for child 
processes and (for waitpid) if the process group specified by 
pid does not exist, or is not a child. 


[EINTR] wait returned due to the receipt of a signal. 
(EINVAL) if the value of the options argument is not valid. 
SEE ALSO 


exec(2), exit(2), fork(2), intro(2), pause(2), ptrace(2), signal(2) 
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WARNINGS 
wait fails and its actions are undefined if stat_loc points to an invalid 


address. 

DIAGNOSTICS 
If wait returns due to the receipt of a signal, a value of —1 is returned to the 
calling process and errno is set to EINTR. If wait returns due to a stopped or 
terminated child process, the process ID of the child is returned to the calling 
process. Otherwise, a value of -1 is returned and errno is set to indicate the 
error. 
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NAME 
write — write on a file 


SYNOPSIS 
int write (fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 


DESCRIPTION 
fildes is a file descriptor obtained from a creat(2), open(2), dup(2), fentl(2), 
or pipe(2) system call. 


write attempts to write nbyte bytes from the buffer pointed to by buf to the 
file associated with the fildes. 


On devices capable of seeking, the actual writing of data proceeds from the 
position in the file indicated by the file pointer. Upon return from write, the 
file pointer is incremented by the number of bytes actually written. 


On devices incapable of seeking, writing always takes place starting at the 
current position. The value of a file pointer associated with such a device is 
undefined. 


If the O_APPEND flag of the file status flags is set, the file pointer is set to the 
end of the file prior to each write. 


For regular files, if the O_SYNC flag of the file status flags is set, the write does 
not return until both the file data and file status have been physically 
updated. This function is for special applications that require extra reliability 
at the cost of performance. For block special files, if O_SYNC is set, the write 
does not return until the data has been physically updated. 


Awrite to a regular file will be blocked if mandatory file/record locking is set 
(see chmod(2)), and there is a record lock owned by another process on the 
segment of the file to be written. If O.NONBLOCK is not set, the write sleeps 
until the blocking record lock is removed. 


For STREAMS (see intro(2)] files, the operation of write is determined by the 
values of the minimum and maximum nbyte range (packet size) accepted by 
the stream. These values are contained in the topmost stream module. 
Unless the user pushes (see I_LPUSH in streamio(7)) the topmost module, 
these values can not be set or tested from user level. If nbyte falls within the 
packet size range, nbyte bytes are written. If nbyte does not fall within the 
range and the minimum packet size value is zero, write breaks the buffer into 
maximum packet size segments prior to sending the data downstream (the 
last segment may contain less than the maximum packet size). If nbyte does 
not fall within the range and the minimum value is non-zero, write fails with 
errno set to ERANGE. Writing a zero-length buffer (nbyte is zero) sends zero 
bytes with zero returned. 


For STREAMS files, if O NONBLOCK is not set and the stream cannot accept 
data (the stream write queue is full due to internal flow control conditions), 
write blocks until data can be accepted. O_NDELAY prevents a process from 
blocking due to flow control conditions. If O.NONBLOCK is set and the stream 
can not accept data, write fails. If O.NONBLOCK is set and part of the buffer 
has been written when a condition in which the stream can not accept 
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additional data occurs, write terminates and returns the number of bytes 


written. 

write fails and the file pointer remains unchanged if any of the following are 

true: 

[EAGAIN] Mandatory file/record locking was set, O.NONBLOCK was set, 
and there was a blocking record lock. 

[EAGAIN] Total amount of system memory available when reading via 
raw I/O is temporarily insufficient. 

{EAGAIN] Attempt to write to a stream that can not accept data with 
the O_NONBLOCK flag set. 

[EBADF] fildes is not a valid file descriptor open for writing. 


[EDEADLK] The write was going to go to sleep and cause a deadlock situa- 
tion to occur. 


[EFAULT] buf points outside the process’s allocated address space. 

(EFBIG] An attempt was made to write a file that exceeds the process’s 
file size limit or the maximum file size (see ulimit(2)). 

[EINTR] A signal was caught during the write system call. 

[EINVAL] Attempt to write to a stream linked below a multiplexor. 

([ENOLCK] The system record lock table was full, so the write could not 
go to sleep until the blocking record lock was removed. 

[ENOSPC] During a write to an ordinary file, there is no free space left 
on the device. 

[FIO] A hangup occurred on the stream being written to. 

{EIO] An I/O error occurred while reading from or writing to the file 
system. 

(E10) The process is in a background process group and is attempt- 


ing to write to its controlling terminal. TGSTOP is set, the 
process is neither ignoring nor blocking SIGTTOU signals, and 
the process group of the process is orphaned. 


[EPIPE and SIGPIPE signal] 
An attempt is made to write to a pipe that is not open for 
reading by any process. 

[ERANGE] Attempt to write to a stream with nbyte outside specified 
minimum and maximum write range, and the minimum value 
is non-zero. 


[ENOMEM] The size of the write request to a raw device would have 
required the process to exceed its maximum resident set size. 


If a write requests that more bytes be written than there is room for (e.g., the 
ulimit (see ulimit(2)) or the physical end of a medium), only as many bytes as 
there is room for are written. 


For example, suppose there is space for 20 bytes more in a file before reaching 
alimit. A write of 512-bytes returns 20. The next write of a non-zero number 
of bytes gives a failure return (except as noted below). 
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Write requests to a pipe (or FIFO) of PIPE_BUF bytes or less will not be inter- 
leaved with data from other processes doing writes on the same pipe. Writes 
of greater than PIPE_BUF bytes may have data interleaved, on arbitrary 
boundaries, with writes by other processes to that same pipe. 


If the pipe being written has the O_NONBLOCK flag of the file flag word set, 
and the number of bytes in the transfer is PIPE_BUF bytes or less, a write toa 
pipe which hasn’t buffer space available to contain the entire transfer request 
returns a count of -1 and sets errno to EAGAIN. If the number of bytes in the 
write request is greater than PIPE_BUF and O_NONBLOCK is set, the write 
may transfer as many bytes as can fit into the pipe at that time, and return 
the number of bytes actually transferred. 


If O_NONBLOCK is clear, writes to a "full" pipe (or FIFO) block until buffer 
space becomes available in that pipe. If the number of bytes requested to 
transfer is greater than PIPE_BUF, then the transfer may be done in several 
pieces as buffer space in that pipe becomes available. Under these circum- 
stances, data from other processes writing to that pipe may be interleaved in 
the pipe with the data from this transfer. If the number of bytes requested is 
PIPE_BUF or less, the process blocks until space is available in the pipe for the 
entire transfer. When buffer space becomes available in that pipe, the data is 
transferred atomically into that pipe’s buffer. 


Awrite to a STREAMS file can fail if an error message has been received at the 
stream head. In this case, errno is set to the value included in the error mes- 
sage. 


SEE ALSO 
intro(2), creat(2), dup(2), fentl(2), intro(2), lseek(2), open(2), pipe(2), ulimit(2) 
DIAGNOSTICS 
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Upon successful completion, the number of bytes actually written is returned. 
Otherwise, —1 is returned and errno is set to indicate the error. 
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NAME 
intro — introduction to Sequent system calls 


SYNOPSIS 
#include <errno.h> 


DESCRIPTION 
This section describes the Sequent-specific system calls. Most of these calls 
have one or more error returns. An error condition is indicated by an other- 
wise impossible returned value. This is almost always —1 or the NULL pointer; 
the individual descriptions specify the details. An error number is also made 
available in the external variable errno. errno is not cleared on successful 
calls, so it should be tested only after an error has been indicated. 


Each system call description attempts to list all possible errors. Refer to the 
introduction to Section 2 for a complete list of the error numbers and their 
names as defined in <errno.h>, and for more information about system calls. 


SEE ALSO 
intro(2) 
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NAME 


bdfiush — update daemon 


SYNOPSIS 


bdflush (autoup, bdflushrate) 
int autoup; 
int bdflushrate; 


DESCRIPTION 


NOTES 
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bdflush starts a daemon that flushes modified disk buffers out to disk. Only 
one daemon can be active at any given time. 


autoup is the maximum age of delayed write buffers in seconds before they 
get written out. bdflushrate is the rate at which bdflush checks for delayed 
write buffers. 


bdflush fails if any of the following is true: 


[EBUSY] If another daemon is already active. 
[EINVAL] If either autoup or bdflushrate is negative. 
[EPERM] If the caller is not the superuser. 


This system call never returns. 


This is a Sequent library routine. To use it, specify the -lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME ; 
fvhangup — virtually hangup the specified controlling terminal 


SYNOPSIS 
fvhangup(line) 
char ‘line; 

DESCRIPTION 
fvhangup is used by the terminal set-up process getty(1a) and some other 
processes to give users controlled access to terminals at login by revoking 
access of the previous users’ processes to the terminal. To effect this, 
fvhangup searches the system tables for references to the specified line , 
revoking access permissions on each instance of the terminal that it finds. 
Further attempts to access the terminal by the affected processes yield /O 


errors (EIO). 
This call is available only to the superuser. 
ERRORS 
[EPERM] The caller is not the superuser. 
[ENOTTY] The specified line is not a character special device. 
[ESRCH] No file descriptors could be found that are currently using 
this line. 
SEE ALSO 
getty (la) 
NOTES 


Any I/O operation in progress on the line may succeed. 


Care should be taken to ensure that no new opens can be performed on the 
device during the call to fvhangup, as such opens may not be subject to the 
effects of fvhangup. 

This is a Sequent library routine. To use it, specify the -lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 


12/89 1 


. DYNIX/ptx GET_PROCESS_STATS(2SEQ) 


NAME 
get_process_stats — get resource utilization information 


SYNOPSIS 
#include <sys/types.h> 
#include <sys/procstats.h> 


get_process_stats(tv, who, pst, cpst) 
timeval_t *tv; 

int who; — 

struct process_stats *pst, *cpst; 


DESCRIPTION 
get_process_stats returns information describing the resources utilized by 
the process identified by who and all its terminated child processes. who is 
either the pid of the desired process, or the value PS_SELF, defined in the 
header file <sys/procstats.h>. If who is given value PS_SELF, the statistics 
returned are for the calling process. In order to get statistics about the pro- 
cess who, the caller must either be superuser, or have the same real or effec- 
tive uid as the process identified by who. tv returns the current time of day. 
If pst or cpst are non-zero, the buffers they point to are filled in with the fol- 
lowing structure: 


struct process stats { 
timeval_t ps_utime; /*user time */ 
timeval_t ps_stime; /*system time */ 


ulong ps_maxrss; /*max resident set size (in HW pages) */ 
ulong ps_pagein; /*page faults that resulted in I/O */ 
ulong ps_reclaim; /*pages reclaimed from free/dirty list */ 


ulong ps_zerofill; /*pages zero filled on demand */ 
ulong ps_pffincr; /*times PFF increased process’s RSS */ 
ulong ps_pffdecr; /*times PFF decreased process’s RSS */ 


ulong ps_swap; /*times process was swapped */ 
ulong ps_syscall; /*number of system calls */ 
ulong ps_volcsw; /*voluntary context switches */ 
ulong ps_involcsw; /*involuntary context switches */ 
ulong ps_signal; /*signals received */ 

ulong ps_lread; /*filesystem "logical" reads */ 
ulong ps_lwrite; /*filesystem "logical" writes */ 
ulong ps_bread; /*filesystem disk reads */ 
ulong ps_bwrite; /*filesystem disk writes */ 
ulong ps_phread; /*raw device reads */ 

ulong ps_phwrite; /*raw device writes */ 


The fields are interpreted as follows: 


ps_utime Total amount of time spent executing in user mode 

ps_stime Total amount of time spent in the system executing on 
behalf of the process(es) 

ps_maxrss Maximum resident set size utilized in pages (as defined by 
getpagesize(2)) 
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ps_pagein Number of page faults serviced which required V/O activity 


ps_reclaim Number of page faults serviced without any V/O activity; 
here V/O activity is avoided by reclaiming a page frame 
from the list of pages awaiting reallocation 


ps_zerofill Number of pages which are zero-filled on demand 

ps_pffiincr Number of times a process’s resident set size was 
increased by the kernel 

ps_pffdecr Number of times a process’s resident set size was 
decreased by the kernel 

ps_swap Number of times a process was swapped out of main mem- 
ory 

ps_syscall Number of system calls performed 

ps_volcsw Number of times a context switch resulted due to a process 


voluntarily giving up the processor before its time slice 
was completed (usually to await availability of a resource) 


ps_involesw Number of times a context switch resulted due to a higher 
priority process becoming runnable or because the current 
process exceeded its time slice 


ps_signal Number of signals received 
ps_lread Number of read system calls performed 
ps_lwrite Number of write system calls performed 
ps_bread Number of reads from disk performed to service file system 
logical reads 
ps_bwrite Number of writes to disk performed to service file system 
logical writes 
ps_phread Number of reads to raw disk devices 
ps_phwrite Number of writes to raw disk devices 
SEE ALSO 
wait(2) 
DIAGNOSTICS 


In the event of a failure, the system call returns a value of -1, and errno is set 
to one of the values below. 


[EFAULT] The memory pointed to by tv, cpst, or pst lies outside the 
valid address space for the process. 


[EPERM] Permission is denied to the information about the process 
specified by who. This means the caller is not superuser, and 
that the real or effective uid’s of the caller do not match the 
real or effective uid of the process identified by who. 


[ESRCH] The process specified by who does not exist. 
[EAGAIN] The process specified by who has been swapped out. 


NOTES 
The numbers ps_bread and ps_bwrite account only for real I/O ; data 
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supplied by the cacheing mechanism is charged only to the first process to 


& read or write the data. 

This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 

BUGS 
Due to the multiprocessing nature of the operating system, it is possible for 
the CPU time (user + system time) for a child process to exceed the elapsed 
real time, especially if the child process forks and waits for children of its 
own. 
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NAME 
getdtablemax — get maximum in-use descriptor table index 


SYNOPSIS 
int getdtablemax 


DESCRIPTION 
Each process has a fixed size descriptor table which is guaranteed to have at 
least OPEN_MAX slots. The entries in the descriptor table are numbered with 
small integers starting at 0. getdtablemax returns the highest in-use index 
of this table. The system guarantees that descriptor table indices greater 
than getdtablemax and less than getdtablesize are not in use by the calling 
process. 

SEE ALSO 
intro(2), close(2), dup(2), open(2), getdtablesize(2seq), setdtablesize(2seq) 

NOTES 
This is a Sequent library routine. To use it, specify the —lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
getdtablesize — get descriptor table size 


SYNOPSIS 
int getdtablesizeQ 


DESCRIPTION 
Each process has a fixed size descriptor table which is guaranteed to have at 
least OPEN_MAX slots. The entries in the descriptor table are numbered with 
small integers starting at 0. getdtablesize returns the size of this table. 


SEE ALSO 
intro(2), close(2), dup(2), open(2), setdtablesize(2seq) 

NOTES 
This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME . 
getpagesize — get system page size 
SYNOPSIS 

int getpagesize() 


DESCRIPTION 
getpagesize returns the number of bytes in a page. Page granularity is the 
granularity of many of the memory management calls. 
The page size is a system page size and may not be the same as the underly- 
ing hardware page size. 


SEE ALSO 
sbrk(2) 

NOTES 
This is a Sequent library routine. To use it, specify the -lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 


mmap — map an open file into the process’s address space 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/mman.h> 


mmap(addr, len, prot, share, fd, pos) 


caddr_t addr; /* starting virt-addr */ 

int len; /* length (bytes) to map */ 

int prot; /* RO, RW encoding */ 

int share; /* private/shared modifications */ 

int fd; /* open file to be mapped */ 

off_t pos; /* where in file to begin map */ 
DESCRIPTION 
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mmap causes the file referenced by fd, starting at byte pos for len bytes in 
the file, to be mapped into the calling process’s address space, starting at vir- 
tual address addr for len bytes, using protection specified by prot; modifica- 
tions to the mapped memory are either private to the process or shared, as 
specified by share. mmap can be used to allocate regions of shared memory, 
to map files into memory, and to access special regions of the physical address 
space. 


fd must reference an open regular (IFREG) or character special (IFCHR) file. 
The device driver that implements the IFCHR special file must support map- 
ping for this to succeed. Typically, a regular file is used to map shared mem- 
ory. 

The share argument specifies whether modifications to a mapped file are to 
be kept private to the calling process or shared with other processes accessing 
the file. If share is MAP_SHARED , all modifications to the file are shared with 
others who have it concurrently mapped. If share is MAP_PRIVATE , all modi- 
fications are local to the calling process; this doesn’t restrict other processes 
from mapping the file. MAP_SHARED and MAP_PRIVATE do not restrict read 
and write system-calls. If share is MAP_ZEROFILL, the space indicated from 
addr for len bytes is replaced by private pages that are zero-filled when refer- 
enced. MAP_ZEROFILL ignores the fd argument, and pos is ignored other 
than being checked for alignment (specifying fd and pos = 0 is recommended). 


The prot argument should be PROT_WRITE for write access to the mapped 
region, PROT_READ for read access, PROT_EXEC for executable access. These 
values can be ORed to obtain read-write access, etc. For programming conve- 
nience, PROT_RDWR is defined as (PROT_READ|PROT_WRITE). The file access 
permissions on fd must allow the requested access. The prot argument 
affects only the calling process; other processes mapping the same file may 
have different access. 


The addr, len, and pos arguments must be integral multiples of the system 
page size, as defined by getpagesize(2). It is possible to map over previously 
mapped pages. The newly created address space cannot overlap with a shared 
memory region created by the shmat(2) system call. If addr and len specify a 
nonexistent part of the process’s address space, the process’s data segment is 
grown to accommodate the request. The process’s break address (see brk(2)) 
js unchanged. Reference to any holes between the mapped region and the rest 
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of the data segment result in a segmentation fault (SIGSEGV). mmap does 
not allow mapping over text or stack pages. 


When memory is mapped to a regular file, the file acts like a paging area for 
the mapped memory region. read and write operations to mapped regions of 
the file also affect the corresponding memory. The memory contents are 
copied out to the file when the process is swapped or when it exits, or when the 
region is otherwise unmapped by the last process that has it mapped. For pro- 
grams that use shared memory but do not need a permanent disk image of the 
memory, the file associated with fd can be unlinked (see unlink(2)) even 
before the call to mmap: if the file is unlinked when the region is unmapped, 
the disk space is not updated. A close(2) operation on the fd does not unmap 
the region, that is, the mapping persists. The map is implicitly deleted on 
exit(2) or by explicitly calling munmap(2seq). 

Regular files have their size rounded up to a file-system block boundary. Any 
non-existent space in the file at the time of the mmap request (for example, in 
a sparse file) is allocated, and filled with zeros when referenced. Both of these 
operations require write access to the file. 


The type of file referenced may impose further restrictions on the pos, offset, 
or other parameters. Refer to the manual entry of the relevant device driver 
(for example, pmap(7)) for details. 


muap can be called multiple times with the same file descriptor, resulting in 
several (possibly overlapping) mapped regions. A process can have up to NUM- 
MAP regions mapped simultaneously; mappings that are completely over- 
lapped by subsequent mappings are not counted in this total. Mappings which 
use the same file descriptor, and addr and pos arguments which align virtu- 
ally with a previous mapping, also don’t count in this total; the simplest case 
is mapping more of a file, starting from the end of a previous mapping. Ifa file 
is closed and reopened between two calls to mmap, they are counted as sepa- 
rate maps. 


All mapped files remain mapped in both the parent and child process after a 
fork. All exec and exit system calls, when successful, remove all maps the 
calling process had established. Ifa process has any maps, vfork behaves 
exactly like fork. A child of a vfork that has not yet execed a new image can- 
not successfully execute mmap. 


There are three types of mapping: paged, physical, and non-paged memory. 
The type of mapping is determined by the type of file being mapped. Paged 
maps support shared memories and mapped regular files. Physical maps deal 
with hardware that has restrictive access capability (for example, the MUL- 
TIBUS address space). Non-paged memory maps are typically used for special 
reserved areas of system memory; they are assumed to behave exactly like 
memory, supporting accesses of arbitrary size and alignment, DMA, etc. 


System services (raw I/O , read/write, stat, etc.) are supported in paged and 
non-paged memory maps; attempts at such services in physically mapped 
address space result in an error, typically EFAULT. Core dumps include a 
copy of any mapped address space; however, physically mapped addresses read 
as zero. 

Regular files (IFREG) are always page-mapped. Character special files (IFCHR) 
can support paged, physical, or non-paged maps, depending on the underlying 
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hardware. Physical and non-paged maps are always valid in the process 
address space; references do not cause a page fault. 
When mmap increases a program’s address space, it also attempts to increase 
its allowable resident set size. 

DIAGNOSTICS 
mmap returns 0 when successful. Otherwise it returns -1 and errno is set to 
indicate the error. 

EXAMPLES 
The following code sets up a 1-Mbyte region of shared memory at the first page 
boundary above the current program break. This region is shared with the 
process’s children and with any other process that maps the file shmem: 


pgsz = getpagesize(); 
shm_base = (char *) (((int)sbrk(0) + (pgsz-1)) & ~(pgsz-1l)); 
fd = open ("shmem", O_CREAT | O_RDWR, 0666); 
mmap (shm_base, 0x100000, PROT_RDWR, MAP_SHARED, fd, 0); 
ERRORS 
[EACCES] fd does not allow the desired access (read or write), or a write- 
only file descriptor was used. 
[EACCES] A mapped regular file must be extended to a file-system block 
boundary, or the file must have space allocated, and the file 
descriptor is read-only. 


(EFBIG] The pos and len arguments would create too large a file. 
(EINVAL) addr, pos, or len is not a multiple of the system page size. 


[EINVAL] prot did not specify at least one of PROT_WRITE or PROT_READ; 
share did not specify MAP_SHARED, MAP_PRIVATE, or 
MAP_ZEROFILL; or share specified MAP_ZEROFILL but prot did 
not contain PROT_RDWR. 


[EINVAL] fd does not represent a regular or character special file. 
[EINVAL] The process is the child of a vfork. 


[EINVAL] The area defined by the addr and len arguments overlaps text 
or stack pages of the process, or an area created by shmat. 


[EINVAL] mmapping a file which has mandatory record locking enabled is 
not supported. 


[EMFILE} The system-defined per-process limit on the number of mmaped 
files (currently NUMMAP) was exceeded. 


[ENFILE] The system-wide limit on the number of mapped regular files 
was exceeded. This limit is defined by the variable nmfile in 
param_space.c. 


[ENODEV] The device driver indicated by fd does not support mapping. 


[ENOMEM] _ There is no swap space for the page table of a mapped regular 
file, or you are trying to create too large a process. 


[ENOSPC] Amapped regular file was sparse and there was insufficient 
space in the file-system to satisfy the request. 
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Other error values may be returned by somie device drivers when requested to 
map. See the relevant driver manual entry for details. 
SEE ALSO 
munmap(2seq), pmap(7), vm_ctl(seq2), fork(2), exec(2), getpagesize(seq2) 
NOTES 
Due to a hardware restriction, PROT_WRITE implies PROT_READ also. 
PROT_EXEC is ignored. 


To minimize overhead, mapped regions should be kept as close as possible to 
the low end of process memory. 


Address space holes under the process break read as zeros in core files. 


This is a Sequent library routine. To use it, specify the -lseq option to link 
’ with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 


BUGS 
Amapped file may not be truncated. 


Ifa file is extended to a file-system block boundary, its original size is lost. 


Current restrictions on what parts of the address space can be re-mapped 
should be lifted. 
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NAME 

munmap — unmap part of the process’s address space 
SYNOPSIS 

munmap(addr, len) 

caddr_t addr; /* starting virt-addr */ 

int len; /* length (bytes) to unmap */ 
DESCRIPTION 


munmap removes a mapping created by mmap(2seq). The addr and len 
arguments must be integral multiples of the system page size, as defined by 
getpagesize(2seq). 

After successful completion of munmap, the address space from addr 
through addr+len-1 does not exist and will result in a segmentation fault 
(SIGSEGV) if referenced. 


DIAGNOSTICS 
Munmap returns zero when successful. Otherwise it returns -1 and errno is 
set to indicate the error. 


ERRORS 
[EINVAL] addr or len is not a multiple of the system page size. 
[EINVAL] The area defined by addr and len overlaps the text or stack 
segment or a non-existent part of the address space. 
SEE ALSO 
mmap(2seq), vm_ctl(2seq), getpagesize(2seq) 
NOTES 


The current implementation can unmap only data space. 
Any address space holes created by munmap read as zeros in a core file. 


This is a Sequent library routine. To use it, specify the -lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 


proc_ctl — control over various process attributes 


SYNOPSIS 


#include <sys/time.h> 
#include <sys/resource.h> 


proc_ctl(cmd, who, arg) 
int cmd; 

int who; 

int arg; 


DESCRIPTION 


This call supports manipulation of various process attributes. The only cur- 
rently supported cmd is PROC_PRIOAGE. cmd, who, and arg are interpreted 
as follows for cmd = PROC_PRIOAGE: 


who is a process ID (pid); zero means the calling process. Priority aging of the 
selected process is enabled or disabled depending on arg being non-zero or 
zero (respectively). When priority aging is disabled, the system no longer 
takes the calling process’s CPU usage history into consideration when select- 
ing among processes torun. The calling process’s effective uid must be root or 
the same as the selected process. Any uid can enable priority aging. A root 
process, or any process if the system is configured for it, can disable priority 
aging. The priority aging attribute is inherited across fork and exec. 


DIAGNOSTICS 


Upon successful completion, a value of 0 is returned. Otherwise, a value of ~1 
is returned and errno is set to indicate the error. 


ERRORS 


proc_ctl fails if one or more of the following are true: 
[EINVAL] cmd is not one of the supported values. 


({EPERM] Caller is not root for disabling priority aging, and the binary 
configuration disallows this. 


[EPERM] The caller is not root and the effective uid is not the same as the 
selected process. 


[ESRCH] who specifies a non-existent process. 


SEE ALSO 


NOTES 
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nice(2), vm_ctl(2seq) 


Binary configuration of ability for non-root processes to disable priority aging 
is provided via a variable in the kernel configuration file param_space.c: 
root_prio_noage. If this variable is non-zero, only root can disable priority 
aging. 

This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
quotactl — manipulate disk quotas 


SYNOPSIS 
#include <sys/ufsquota.h> 


quotactl(cmd, special, uid, addr) 
int cmd; 
char *special; 
int uid; 
caddr_t addr; 

DESCRIPTION 
The quotactl call manipulates disk quotas. The cmd parameter indicates a 
command to be applied to the user ID uid. special is a pointer to a null-ter- 
minated string containing the pathname of the block special device for the 
filesystem being manipulated. The block special device must be mounted. 
addr is the address of an optional, command-specific data structure that is 
copied in or out of the system. The interpretation of addr is given with each 
command below. 


Q_ QUOTAON 
Turn on quotas for a filesystem. addr is a pointer to a null-ter- 
minated string containing the pathname of the file containing the 
quotas for the filesystem. The quota file must exist and the commands 
for the quota system require that it be named quotas. This call is 
restricted to the superuser. 


Q_QUOTAOFF 
Turn off quotas for a filesystem. This call is restricted to the 
superuser. 


Q.GETQUOTA 
Get disk quota limits and current usage for user uid. addrisa 
pointer to a struct dqblk structure (defined in <sys/ufsquota.h>). Only 
the superuser may get the quotas of another user. 


Q_SETQUOTA 
Set disk quota limits and current usage for user uid. addrisa 
pointer to a struct dqblk structure (defined in <sys/ufsquota.h>). This 
call is restricted to the superuser. 

Q_SETQLIM 
Set disk quota limits for user uid. addr is a pointer to a struct dqblk 
structure (defined in <sys/ufsquota.h>). This call is available only to 
the superuser. 

Q SYNC 
Update the on-disk copy of quota usages. This call is restricted to the 
superuser. If special is NULL, all filesystems with quotas enabled 
have their on-disk copy of quota usages updated. 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 


js returned and errno is set to indicate the error. 
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ERRORS 

quotactl fails if any of the following occurs: 

[EACCES] The addr parameter, is being interpreted as the path ofa 
quota file that exists but is not a regular file or is not on the 
filesystem pointed to by the special parameter. 

[EFAULT] An invalid addr is supplied; the associated structure could 
not be copied in or out of the kernel. 

[EINVAL] emd is invalid. 

[ENODEV] The special parameter is not a mounted filesystem. 

[ENOTBLK] The special parameter is not a block device. 

[EPERM] The call is privileged and the caller was not the superuser. 

[ESRCH) The quota table is full or the special parameter is a mounted 
filesystem without quotas enabled. 

SEE ALSO 
quotaon(1M), quotacheck(1M) 
NOTES 


This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
readlink — read value of a symbolic link 


SYNOPSIS 
int readlink(path, buf, bufsiz) 
char *path, *buf; 
int bufsiz; 

DESCRIPTION 
readlink places the contents of the symbolic link name in the buffer buf 
which has size bufsiz. The contents of the link are not null-terminated when 
returned. 


DIAGNOSTICS 
Tf successful, the count of characters is placed in the buffer. Otherwise a—1 is 
returned and errno is set to indicate the error. 


ERRORS 
readlink fails if any of the following are true: 


[EACCES] Search permission is denied on a component of the path pre- 
fix. 
{EFAULT] Buf extends outside the process’s allocated address space. 
[EINVAL] The named file is not a symbolic link. 
(EIO] An I/O error occurred while reading from or writing to the file 
system. 
[ELOOP] Too many symbolic links were encountered in translating the 
pathname. 
[ENOENT] The pathname was too long. 
{ENOENT] The named file does not exist. 
(ENOTDIR] Acomponent of the path prefix is not a directory. 
[ENXIO] The named file is not a symbolic link. 
[EPERM] The effective user ID does not match the owner of the file and 
the effective user ID is not the superuser. 
SEE ALSO 
Istat(2), stat(2), symlink(2seq) 
NOTES 


This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 


readv — read vector from file 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/uio.h> 

int readv(fildes, iov, iovent) 
int fildes; 

struct iovec *iov; 

int iovent; 


DESCRIPTION 
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fildes is a file descriptor obtained from a creat(2), open(2), dup(2), fentl(2), 
or pipe(2) system call. 


readv attempts to read data from the file associated with fildes, scattering 
the data into the iovent buffers specified by the iovec array: iov[0], iov{1], ..., 
iov{iovent — 1]. 


For readv, the iovec structure is defined as 


struct iovec { 
caddr_tiov_base; 
int jov_len; 


}; 
On devices capable of seeking, the readv starts at a position in the file given 
by the file pointer associated with fildes. Upon return from readv, the file 
pointer is incremented by the number of bytes actually read. 


Devices that are incapable of seeking always read from the current position. 
The value of a file pointer associated with such a file is undefined. 


Upon successful completion, readv returns the number of bytes actually read 
and placed in the buffer; this number may be less than the sum of the iov_len 
fields in iov if the file is associated with a communication line (see ioctl(2) 
and termio(7)), or if the number of bytes left in the file is less than specified 
by iov. A value of 0 is returned when an end-of-file has been reached. 


A readv from a STREAMS (see intro(2)) file can operate in three different 
modes: byte-stream mode, message-nondiscard mode, and message-discard 
mode. The default is byte-stream mode. This can be changed using the 
LSRDOPT ioctl request (see streamio(7)), and can be tested with the 
I_GRDOPT ioctl. In byte-stream mode, readv retrieves data from the stream 
until it has retrieved enough data to fill the iov buffers, or until there is no 
more data to be retrieved. Byte-stream mode ignores message boundaries. 


In STREAMS message-nondiscard mode, readv retrieves data until it has read 
as much data as specified by iov, or until it reaches a message boundary. If 
the readv does not retrieve all the data in a message, the remaining data are 
replaced on the stream, and can be retrieved by the next readv or getmsg(2) 
call. Message-discard mode also retrieves data until it has retrieved filled iov, 
or it reaches a message boundary. However, unread data remaining in a mes- 
sage after the readv returns are discarded, and are not available for a subse- 
quent readv or getmsg. 
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When attempting to read from a regular file with mandatory file/record lock- 
ing set (see chmod(2)), and there is a blocking (i.e., owned by another process) 
write lock on the segment of the file to be read: 

If O_NDELAY is set, the read returns a -1 and sets errno to EAGAIN. 


If O_NDELAY is clear, the read sleeps until the blocking record lock is 
removed. 


When attempting to read from an empty pipe (or FIFO): 
If O_NDELAY is set, the read returns a 0. 


If O_NDELAY is clear, the read blocks until data is written to the file or 
the file is no longer open for writing. 
_ When attempting to read a file associated with a tty that has no data cur- 
rently available: 


If O_NDELAY is set, the read returns a 0. 
If O_NDELAY is clear, the read blocks until data becomes available. 


When attempting to read a file associated with a stream that has no data cur- 
rently available: 


If O_NDELAY is set, the read returns a -1 and sets errno to EAGAIN. 
If O_NDELAY is clear, the read blocks until] data becomes available. 


When reading from a STREAMS file, handling of zero-byte messages is deter- 
mined by the current read mode setting. In byte-stream mode, readv accepts 
data until it has read the number of bytes requested by iov, or until there is 
no more data to read, or until a zero-byte message block is encountered. 
readv then returns the number of bytes read, and places the zero-byte mes- 
sage back on the stream to be retrieved by the next read, readv, or getmsg. 
In the two other modes, a zero-byte message returns a value of 0 and the mes- 
sage is removed from the stream. When a zero-byte message is read as the 
first message on a stream, a value of 0 is returned regardless of the read mode. 


A readv from a STREAMS file can only process data messages. It cannot pro- 
cess any type of protocol message and fails if a protocol message is encoun- 
tered at the stream head. 


DIAGNOSTICS 
Upon successful completion, a non-negative integer is returned indicating the 
number of bytes actually read. Otherwise, a —1 is returned and errno is set to 
indicate the error. 


ERRORS 

readv fails if any of the following are true: 

[EAGAIN] Mandatory file/record locking was set, O NDELAY was set, 
and there was a blocking record lock. 

[EAGAIN] Total amount of system memory available when reading via 
raw IO is temporarily insufficient. 

[EAGAIN] No message waiting to be read on a stream and O_NDELAY : 
flag set. 
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{EBADF] 
(EBADMSG] 
[EDEADLK] 


[EFAULT] 


{EINTR] 

[EINVAL] 
[EINVAL] 
[EINVAL] 
[EINVAL] 


{EIO] 


[ENOLCK] 


(ENOMEM] 


READV(2SEQ) 


fildes is not a valid file descriptor open for reading. 
Message waiting to be read on a stream is not a data message. 


The read was going to go to sleep and cause a deadlock situa- 
tion to occur. 


iov or one of the elements in iov points outside the allocated 
address space. 


A signal was caught during the readv system call. 
Attempted to read from a stream linked to a multiplexor. 
iovent was less than or equal to 0, or greater than 16. 
One of the iov_len values in the iov array was negative. 


The sum of the iov_len values in the iov array overflowed a 
32-bit integer. 

An I/O error occurred while reading from or writing to the file 
system. 

The system record lock table was full, so the read could not go 
to sleep until the blocking record lock was removed. 


The size of the read requested from a raw device would have 
required the process to exceed its maximum resident set size. 


A readv from a STREAMS file also fails if an error message is received at the 
stream head. In this case, errno is set to the value returned in the error mes- 
sage. Ifa hangup occurs on the stream being read, readv continues to oper- 
ate normally until the stream head read queue is empty. Thereafter, it 


returns 0. 
SEE ALSO 


creat(2), dup(2), fentl(2), ioctl(2), intro(2), open(2), pipe(2), getmsg(2), read(2), 
writev(2), streamio(7), termio(7) 


NOTES 


This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 

setdtablesize — set descriptor table size 
SYNOPSIS 

setdtablesize(size) 

int size; 
DESCRIPTION 


This function sets the descriptor table size in the calling process to at least the 
minimum of the size argument and a system-defined maximum number of file 
descriptors (binary-configurable). The implementation can grant more file 
descriptors than the number requested. setdtablesize returns the number of 
file descriptors the process can now use. A request to decrease the number of 
file descriptors in a process is honored by closing all open file descriptors with 
indices equal to or greater than size. 


The maximum number of file descriptors is guaranteed to be at least 20. 


Before setdtablesize can be used to increase the number of file descriptors, 
NOFILES and NOFILEEXT must be set as options in the binary configuration 
file. 


The new descriptor table size is inherited across fork(2) and kept across 
exec(2) system calls. 


DIAGNOSTICS 
If successful, the number of usable file descriptors in the calling process is 
returned. Otherwise, a —1 is returned, and the global variable errno is set to 
indicate the error. 


ERRORS 
(EAGAIN] The system was temporarily unable to allocate sufficient 
memory resources to satisfy the request. 
{EINVAL] The size argument was invalid (size is less than zero). 
[ENFILE] The system had no free open-file table extension objects. 
SEE ALSO 
intro(2), close(2), dup(2), getdtablesize(2seq), open(2) 
NOTES 


This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
setgroups — set group access list 
SYNOPSIS 
finclude <sys/types.h> 
setgroups(gidsetsize, grouplist) 
int gidsetsize; 
gid_t grouplist[]; 
DESCRIPTION 
setgroups sets the group access list of the current user process according to 
the array grouplist. The parameter gidsetsize indicates the number of 


entries in the array and must be no more than NGROUPS_MAX, as defined in 
<limits.h>. 


Only the superuser may set new groups. 


DIAGNOSTICS 
A 0 value is returned on success, —1 on error with errno set to indicate the 
error. 
ERRORS 
setgroups fails if: 
[EFAULT] The address specified for grouplist is outside the process 
address space. 
[EINVAL] The size of group array is greater than NGROUPS_MAX. 
[EPERM] The caller is not the superuser. 
SEE ALSO 
getgroups(2) 
NOTES 


This is a Sequent library routine. To use it, specify the -lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
sigcontext — get signal context 


SYNOPSIS 
#include <signal.h> 


sigcontext(req, addr); 
int req; 
int *addr; 

DESCRIPTION 
sigcontext allows users to determine the context of the signal being delivered 
to a signal handler. The data, which can be returned or set to the location 
specified by addr, can be requested from within a signal handler by setting 
req to one of the following: 


SF_SIGNO 
requests the current signal number. 


SF_CODE 
requests the code value. This is set by SIGILL, SIGFPE, SIGSEGV, 
and SIGPWR (on SSM based systems) signals to indicate the rea- 
son for the signal on an exception (see signal.h and fpu.h). For all 
other reasons (including use of kill(2) ), the value -1 is returned. 


SF_SYSCODE 
Indicates the system cal] number if the signal was taken during 
a system call (see syscall.h and sysseq.h), otherwise returns -1. 


SF_TRAPCODE 
Indicates the machine trap number if the signal was taken dur- 
ing a trap (see trap.h), otherwise returns -1. 


SF_SEGVCODE 
requests the illegal address in the case of SIGSEGV. For all other 
signals this value is undefined. . 


SF_PC 
requests the value of the program counter at the time the signal 
was delivered. 


SF_SP 
requests the value of the stack pointer at the time the signal was 
delivered. 


SF_RO 
requests the value of the first temporary register at the time the 
signal was delivered. 


SF_CODE_DATA 
requests the additional data set by some of the signals (such as 
SIGFPE ). This is only valid if one of the SF_CODE fields is set 
(which should be checked first). 


SF_SET_PC 
sets the return program counter to be addr. 
The information requested relates to the last signal caught from a signal han- 
dler, and therefore nested signal handlers may request information about the 
signal that caused the handler to be invoked. The vaue is undefined when the 
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data is called outside of a signal handler or after a longjmp(3). 


DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of —1 
is returned and errno is set to indicate the error. 


ERRORS 
sigcontext fails if one of the following occurs: 
(EFAULT] addr points to memory which is not a valid part of the 
process address space, or no signal frame exists. 
[EINVAL] req is not valid. 
SEE ALSO 
sigaction(2), sigstack(2seq), setjmp(3) 


NOTES 
This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
sigstack — set and/or get signal stack context 


SYNOPSIS 
#include <signal.h> 


struct sigstack [ 
caddr_t 88_Sp; 
int ss_onstack; 

}; 
sigstack(ss, oss); 
struct sigstack *ss, *oss; 

DESCRIPTION 
sigstack allows users to define an alternative stack on which signals are to be 
processed. If ss is non-zero, it specifies a signal stack on which to deliver sig- 
nals and tells the system whether the process is currently executing on that 
stack. When a signal’s action indicates its handler should execute on the sig- 
nal stack (specified with a sigaction(2) call), the system checks to see if the 
process is currently executing on that stack. If the process is not currently 
executing on the signal stack, the system arranges a switch to the signal stack 
for the duration of the signal handler’s execution. If oss is non-zero, the cur- 
rent signal stack state is returned. ss_onstack is zero when executing on the 
normal stack, otherwise it is non-zero. 

DIAGNOSTICS 
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 
is returned and errno is set to indicate the error. 


ERRORS 
sigstack fails and the signal stack context remains unchanged if the following 
occurs: 
(EFAULT] Either ss or oss points to memory that is not a valid part of 
the process address space. 
SEE ALSO 
sigaction(2), setjmp(3) 
NOTES 


Signal stacks are not grown automatically, as is done for the normal stack. If 
the stack overflows, unpredictable results may occur. 

This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
symlink — make symbolic link to a file 

SYNOPSIS 
symlink(namel, name2) 
char *namel, *name2; 

DESCRIPTION 
A symbolic link name? is created to namel (name2 is the name of the file 
created, namelis the string used in creating the symbolic link). Either name 
may be an arbitrary pathname; the files need not be on the same file system. 


DIAGNOSTICS 
Upon successful completion, a 0 is returned. Otherwise, —1 value is returned 
and errno is set to indicate the error. 

ERRORS 
The symbolic link is made unless one or more of the following are true: 


[EACCES] Acomponent of the name2 path prefix denies search permis- 
sion. 

[EEXIST] namez2 already exists. 

(EFAULT] namel or name2 points outside the process’s allocated 
address space. 

(EIO} An I/O error occurred while reading from or writing to the file 
system. 

[ELOOP] Too may symbolic links were encountered in translating the 
pathname. 

[ENOENT] One of the pathnames specified was too long. 

[ENOSPC] The directory in which the entry for the new symbolic link is 


being placed cannot be extended because there is no space left 
on the file system containing the directory. 


[ENOSPC] The new symbolic link cannot be created because there is no 
space left on the file system which will contain the link. 
[ENOSPC] There are no free inodes on the file system on which the sym- 
bolic link is being created. 
[ENOTDIR] Acomponent of the name? prefix is not a directory. 
[EROFS] The file name2 would reside on a read-only file system. 
SEE ALSO 
link(2), In(1), Istat(2), readlink(2seq), unlink(2) 
NOTES 


This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
tmp_affinity — bind a process to a processor 
SYNOPSIS 
#include <sys/tmp_ctLh> 
int tmp_affinity(processor); 
int processor; 
DESCRIPTION 
tmp_affinity allows a process to be bound to a specified logical processor. 
Processor numbers start at zero and are numbered contiguously. Deconfig- 
ured processors are not included. The previous affinity is returned. 


If the processor argument is AFF_NONE, the process is realeased from any 

previous affinity (that is, allowed to migrate). If the processor argument is 

AFF_QUERY, the current affinity, or AFF_NONE is returned, without chang- 

ing the current affinity. 

Only the superuser is allowed to change affinity. 

Affinity is inherited across the fork(2) and exec(2) system calls. 
DIAGNOSTICS 

If successful, either the previous affinity processor number or AFF_NONE is 

returned. On error, —1 is returned and errno is set to indicate the error. 
ERRORS 

The tmp_affinity fails if: 


[ENODEV] processor is either offline or bad. 

(ENXIO] processor is out of range. 

[EPERM] Process does not have superuser capability. 
SEE ALSO 

tmp_ctl(2seq), online(1M) 
NOTES 


This is a Sequent library routine. To use it, specify the -lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 
tmp_ctl — multi-processor control 


SYNOPSIS 
#include <sys/tmp_ctLh> 


int tmp_ctl(command, processor) 
int command, processor; 


DESCRIPTION 
tmp_ctl allows processes to query the status of the processor pool resource. 
Superuser processes can also change the configuration. The defined com- 
mands (from tmp_ctl.h) have the following meanings: 


TMP_NENG 
returns the number of processors configured in the processor pool. 
The processors may be online or offline. However, deconfigured pro- 
cessors will not be included. The processor argument is ignored. 


TMP_OFFLINE 
shuts down a processor. The processor stops dispatching processes 
and is paused. Only the superuser is allowed to offline a processor. 


TMP_ONLINE 
starts up a processor. The processor initializes and begins scheduling 
user processes. Only the superuser is allowed to online a processor. 


TMP_QUERY 
returns the state (TMP_ENG_ONLINE or TMP_ENG_OFFLINE) of the 
selected processor. 


DIGANOSTICS 
The call returns 0 on successful completion, or the desired information in the 
case of the query operations. The call returns —1 on error and errno is set to 
indicate the error. 


ERRORS 
The tmp_ctl fails if: 
[EBUSY] Attempting to offline a processor that has bound drivers or 
bound processes, or attempting to offline the last processor. 
[EINVAL] processor is already offline or online. 
[ENODEV) processor is bad. 
[ENXIO] processor is out of range. 
(EPERM] Process does not have superuser capability and an attempt to 
change the processor pool configuration was made. 
SEE ALSO 
tmp_affinity(2seq), online(1M) 
NOTES 


This is a Sequent library routine. To use it, specify the —lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 


© SYNOPSIS 


truncate, ftruncate — truncate a file to a specified length 


#include <sys/types.h> 
truncate(path, length) 
char *path; 

off_t length; 
ftruncate(fd, length) 
int fd; 

off_t length; 


DESCRIPTION 


truncate causes the file named by path or referenced by fd to be truncated to 
at most length bytes in size. If the file previously was larger than this size, 
the extra data is lost. With ftruncate, the file must be open for writing. 
truncate and ftruncate both interact with mandatory record locking. If the 
file being truncated has locks asserted in the portion of the file being removed, 
truncate and ftruncate block until the overlapping locks are removed. In 
the case of ftruncate, if the fd has the O_NDELAY flag set, the system call 
fails. 


DIAGNOSTICS 


A value of 0 is returned if the call succeeds. If the call fails, a—1 is returned, 
and errno is set to indicate the error. 


ERRORS 
& truncate fails if any of the following is true: 


@ SEE ALSO 
open(2), fentl(2) 
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(EACCES] Acomponent of the path prefix denies search permission. 

[EAGAIN] path references a file with mandatory record locking enabled, 
and the portion of the file being deleted overlaps a record lock. 

[EFAULT] path points outside the process’s allocated address space. 

[EISDIR] The named file is a directory. 

[ENOENT] The pathname was too long. 

[ENOENT] The named file does not exist. 

[ENOTDIR] Acomponent of the path prefix of path is not a directory. 

[EROFS] © The named file resides on a read-only file system. 

[ETXTBSY] The file is a pure procedure (shared text) file that is being exe- 
cuted. 

ftruncate fails if any of the following are true: 

[AGAIN] fd references a file with mandatory record locking enabled, 
and the portion of the file being deleted overlaps a record lock. 

[EBADF] The fd is not a valid descriptor. 

[EIO] An Y/O error occurred while reading from or writing to the file 


system. 
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NOTES ‘ . 
These are Sequent library routines. To use them, specify the -Iseq option to 

link with the Sequent library. Since this is a Sequent extension, code using 

this routine may not be portable to other systems. 


BUGS 
Partial blocks discarded as the result of truncation are not zero filled. This 
can result in holes in files which do not read as zeros. 
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NAME 
& vm_ctl — examine and change virtual memory tuning parameters 
SYNOPSIS 
#include <sys/types.h> 
#include <sys/vmsystm.h> 


vm_ctl(operation, argp) 
int operation; 
union [{ 
struct vm_tune *vmtune; 
unsigned long *procrss; 
booLt onoff; 
} argp; 
DESCRIPTION 
vm_ct] examines and changes virtual memory (VM) related parameters. The 
function performed depends on the value of operation. 


If operation is VM_GETPARAM, vm_ctl fetches the system-wide VM tuning 
parameters into the structure pointed to by vmtune. No special permissions 
are required to obtain this information. 


If operation is VM_SETPARAM, the system-wide VM tuning parameters 

become the values in the structure pointed to by vmtune. Existing processes 

are unaffected by the per-process tuning parameters (such as minimum resi- 

dent set size); new processes, however, are bound by the new values. This 
@ form of the call is available only to the superuser. 


If operation is VM_GETRS, the unsigned long pointed to by proerss is filled 
with the resident set size of the calling process. No special permissions are 
required to obtain this information. 


If operation is VM_SETRS, the resident set size of the calling process is set to 
the unsigned long pointed to by procrss. This value must be within the sys- 
tem-wide bounds currently enforced via the VM_SETPARAM operation 
(described above), and the per-process resident set size restriction. This form 
of the call is available only to the superuser. 


If operation is VM_SWAPABLE, the calling process is declared non-swappable 
if onoff is zero; otherwise, the calling process is declared swappable. The 
swappable attribute is inherited across forks and execs. This form of the call 
is available only to the superuser, unless the proper configuration parameter 
has been altered (see NOTES later). Notice that VM_SWAPABLE has only one 
P. 


If operation is VM_PFFABLE, the calling process is declared non-PFFable if 
onoff is zero; otherwise, the calling process is declared PFFable. When a pro- 
cess is PFFable, its resident set size is altered based on the frequency at which 
the process page-faults. The PFFable attribute is inherited across forks and 
execs. This form of the call is available only to the superuser, unless the 
proper configuration parameter has been altered (see NOTES later). 


DIAGNOSTICS 
If the call succeeds, 0 is returned. Otherwise, a —1 is returned, and errno is 
set to indicate the error. 
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The structure pointed to by vmtune is defined in <sys/umsystm.h> as: 


I @ 


* VM System parameters; tunable. 
* 


* Where appropriate, the units (HW pages or clusters) 
* are noted. 

* PFF rate units (PFFlow, PFFhigh) may change if 

* faults/sec isn’t enough resolution. 


2 


structvm_tune { 
longvt_minRS; /*min # clusters for Rset*/ 
longvt_maxRS; /*max # clusters for Rset;limited by maxRS*/ 
longvt_RSexecslop; /*# HW pages slop in exec*/ 
longvt_RSexecmult; /*Rset size multipler*/ 
longvt_RSexecdiv; /*Rset size divider*/ 
int vt_dirtylow; /*dirty-list low-water mark (HW pgs) */ 
int vt_dirtyhigh; /*dirty-list high-water mark (HW pgs) */ 
int vt_klout_look; /*pageout kluster look-ahead (clusters) */ 
longvt_PFFvtime; /*ticks between PFF adjusts; 0=>no PFF*/ 
longvt_PFFdecr; /*# clusters to decrement if PFF<PFFlow*/ 
longvt_PFFlow; /*low PFF rate, <=PFFhigh (faults/sec) */ 
longvt_PFFincr; /*# clusters to add if PFF > PFFhigh*/ 
longvt_PFFhigh; /*high PFF rate (faults/sec) */ 
longvt_minfree; /*freelist low bound for swap (HW pgs) */ @ 
longvt_desfree; /*freelist high bound for swap (HW pgs) */ 
longvt_maxdirty; /*max dirty-list before swap (HW pgs) */ 

MF 


ERRORS 
vm_ctl fails if any of the following is true: 
[EFAULT] The memory pointed to by vmtune or procrss lies outside 
the valid address space for the process. 
(EINVAL] operation is not one of the supported values. 
(EINVAL) An element of the structure pointed to by vmtune is not 
within permissible range. 
{EPERM] The process does not have the proper permissions to make the 
requested change. 
SEE ALSO 


get_process_stats(2seq), mmap(2seq), munmap(2seq), plock(2), vmtune(1M) 
NOTES 
Setting the resident set size (with VM_SETRS) does not actually change the 


current number of resident pages. Pages are added or removed through nor- 
mal page faulting activity. 


sanity to avoid immediate obvious panics. However, ignorant alterations of 


The system verifies that the tuning parameters at least have some degree of 
tuning parameters will most certainly result in a severe degradation in @ 
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response. ; 
Programs should not mix calls to vm_ctl (only the VM_SWAPABLE case) and 
plock(2). See the NOTES section of plock(2). 


Binary configuration of ability for non-root processes to disable swapping, 
PFF-ing, or adjusting the size of the resident set is provided via three vari- 
ables in the kernel configuration file param_space.c: root_vm_swapable, 
root_vm_pffable, root_vm_setrs, respectively. If any of these variables is 
non-zero, the corresponding function is available only to root processes. 
Notice that root_vm_swapable has only one P. 

This is a Sequent library routine. To use it, specify the -lseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 
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NAME 


writev — write vector on a file 


SYNOPSIS 


#include <sys/types.h> 
#include <sys/uio.-h> 
writev(d, iov, ioveclen) 
int d; 

struct iovec *iov; 

int ioveclen; 


DESCRIPTION 
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fildes is a file descriptor obtained from a creat(2), open(2), dup(2), fentl(2), 
or pipe(2) system call. 


writev attempts to write to the file associated with the fildes, data gathered 
from the iovlen buffers specified by the members of the iovec array: iov[0], 
iov[1], etc. 


On devices capable of seeking, the actual writing of data proceeds from the 
position in the file indicated by the file pointer. Upon return from writev, the 
file pointer is incremented by the number of bytes actually written. 


On devices incapable of seeking, writing always takes place starting at the 
current position. The value of a file pointer associated with such a device is 
undefined. 


If the O_LAPPEND flag of the file status flags is set, the file pointer is set to the 
end of the file prior to each write. 


For regular files, if the O_SYNC flag of the file status flags is set, the write will 
not return until both the file data and file status have been physically 
updated. This function is for special applications that require extra reliability 
at the cost of performance. For block special files, if O_SYNC is set, the write 
will not return until the data has been physically updated. 


A write to a regular file is blocked if mandatory file/record locking is set (see 
chmod(2)), and there is a record lock owned by another process on the seg- 
ment of the file to be written. If O_NDELAY is not set, the write sleeps until 
the blocking record lock is removed. 


Let nbyte represent the sum of all the buffers specified by iov. For STREAMS 
(see intro(2)) files, the operation of writev is determined by the values of the 
minimum and maximum nbyte range (packet size) accepted by the stream. 
These values are contained in the topmost stream module. Unless the user 
pushes (see I_PUSH in streamio(7)) the topmost module, these values can not 
be set or tested from user level. If nbyte falls within the packet size range, 
nbyte bytes are written. If nbyte does not fall within the packet size range 
and the minimum packet size value is zero, writev breaks the buffer into 
maximum packet size segments prior to sending the data downstream (the 
last segment may contain less than the maximum packet size). If nbyte does 
not fall within the packet size range and the minimum value is non-zero, wri- 
tev fails with errno set to ERANGE. Writing a zero-length buffer (nbyte is 
zero) sends zero bytes with zero returned. 
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For STREAMS files, if O_NDELAY is not set and the stream can not accept data 
(the stream write queue is full due to internal flow control conditions), writev 
blocks until data can be accepted. O_NDELAY prevents a process from block- 
ing due to flow control conditions. If O_NDELAY is set and the stream can not 
accept data, writev fails. If O_NDELAY is set and part of the buffer has been 
written when a condition in which the stream can not accept additional data 
occurs, writev terminates and returns the number of bytes written. 


writev fails and the file pointer remains unchanged if one or more of the fol- 
lowing are true: 


[EAGAIN] Mandatory file/record locking was set, O.NDELAY was set, 
and there was a blocking record lock. ‘ 

[EAGAIN] Total amount of system memory available when reading via 
raw I/O is temporarily insufficient. 

[EAGAIN] Attempt to write to a stream that can not accept data with 
the O_NDELAY flag set. 

[EBADF] fildes is not a valid file descriptor open for writing. 

(EDEADLK] The write was going to go to sleep and cause a deadlock situa- 
tion to occur. 

(EFAULT] iov or one of its members points outside the process’s allo- 
cated address space. 

(EFBIG] An attempt was made to write a file that exceeds the process’s 
file size limit or the maximum file size (see ulimit(2)). 

(EINTR] Asignal was caught during the writev system call. 

[EINVAL] Attempt to write to a stream linked below a multiplexor. 

[ENOLCK] The system record lock table was full, so the write could not 
go to sleep until the blocking record lock was removed. 

[ENOSPC] During a writev to an ordinary file, there is no free space left 


on the device. 
{ENXIO] A hangup occurred on the stream being written to. 
[EPIPE and SIGPIPE signal] 


An attempt is made to write to a pipe that is not open for 
reading by any process. 


[ERANGE] Attempt to write to a stream with number of bytes in the 
request outside specified minimum and maximum write 
range, and the minimum value is non-zero. 


[ENOMEM]) The size of the write request to a raw device would have 
required the process to exceed its maximum resident set size. 


(EIO} A hangup occurred on the stream being written to. 

(EIO) An I/O error occurred while reading from or writing to the file 
system. ° 

(EIO] The process is in a background process group and is attempt- 


ing to write to its controlling terminal. TGSTOP is set, the pro- 
cess is neither ignoring nor blocking SIGTTOU signals, and the 
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process group of the process is orphaned. 


[EINVAL] iovent was less than or equal to 0, or greater than 16. 

[EINVAL] One of the iov_len values in the iov array was negative. 

[EINVAL] The sum of the iov_len values in the iov array overflowed a 
32-bit integer. 


Ifa writev requests that more bytes be written than there is room for (e.g., 
the ulimit (see ulimit(2)) or the physical end of a medium), only as many 
bytes as there is room for are written. For example, suppose there is space for 
20 bytes more in a file before reaching a limit. A write of 512-bytes returns 
20. The next write of a non-zero number of bytes gives a failure return (except 
as noted below). 


If the file being written is a pipe (or FIFO) and the O_NDELAY flag of the file 
flag word is set, then write to a full pipe (or FIFO) returns a count of 0. Other- 
wise (O_NDELAY clear), writes to a full pipe (or FIFO) blocks until space 
becomes available. 


A write to a STREAMS file can fail if an error message has been received at the 
stream head. In this case, errno is set to the value included in the error mes- 


sage. 


SEE ALSO 


creat(2), dup(2), fentl(2), intro(2), lseek(2), open(2), pipe(2), readv(2seq), 
ulimit(2), write(2) 


DIAGNOSTICS 
@ Upon successful completion, the number of bytes actually written is returned. 


NOTES 
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Otherwise, —1 is returned and errno is set to indicate the error. 


This is a Sequent library routine. To use it, specify the -Iseq option to link 
with the Sequent library. Since this is a Sequent extension, code using this 
routine may not be portable to other systems. 


